xai-review 0.16.0__tar.gz → 0.18.0__tar.gz

xai_review-0.18.0/PKG-INFO

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: xai-review
+Version: 0.18.0
+Summary: AI-powered code review tool
+Author-email: Nikita Filonov <nikita.filonov@example.com>
+Maintainer-email: Nikita Filonov <nikita.filonov@example.com>
+License: Apache-2.0
+Project-URL: Issues, https://github.com/Nikita-Filonov/ai-review/issues
+Project-URL: Homepage, https://github.com/Nikita-Filonov/ai-review
+Project-URL: Repository, https://github.com/Nikita-Filonov/ai-review
+Keywords: ai,code review,llm,openai,claude,gemini
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: httpx
+Requires-Dist: pyyaml
+Requires-Dist: pytest
+Requires-Dist: loguru
+Requires-Dist: aiofiles
+Requires-Dist: pydantic
+Requires-Dist: pydantic-settings
+Dynamic: license-file
+
+# AI Review
+
+AI-powered code review tool.
+
+[![CI](https://github.com/Nikita-Filonov/ai-review/actions/workflows/workflow-test.yml/badge.svg)](https://github.com/Nikita-Filonov/ai-review/actions/workflows/workflow-test.yml)
+[![codecov](https://codecov.io/gh/Nikita-Filonov/ai-review/branch/main/graph/badge.svg)](https://codecov.io/gh/Nikita-Filonov/ai-review)
+[![PyPI version](https://img.shields.io/pypi/v/xai-review.svg)](https://pypi.org/project/xai-review/)
+[![License](https://img.shields.io/github/license/Nikita-Filonov/ai-review)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/Nikita-Filonov/ai-review?style=social)](https://github.com/Nikita-Filonov/ai-review/stargazers)
+
+_Made with ❤️ by [@NikitaFilonov](https://t.me/sound_right)_
+
+---
+
+## 📑 Table of Contents
+
+- ✨ [About](#-about)
+- 🧪 [Live Preview](#-live-preview)
+- 🚀 [Quick Start](#-quick-start)
+- ⚙️ [️CI/CD Integration](#-cicd-integration)
+    - 🚀 [GitHub Actions](#-github-actions)
+    - 🚀 [GitLab CI/CD](#-gitlab-cicd)
+- 📘 [Documentation](#-documentation)
+- ⚠️ [Privacy & Responsibility Notice](#-privacy--responsibility-notice)
+
+---
+
+## ✨ About
+
+**AI Review** is a developer tool that brings **AI-powered code review** directly into your workflow. It helps teams
+improve code quality, enforce consistency, and speed up the review process.
+
+✨ Key features:
+
+- **Multiple LLM providers** — choose between **OpenAI**, **Claude**, and **Gemini**, or switch anytime.
+- **VCS integration** — works out of the box with GitLab, GitHub (more providers coming).
+- **Customizable prompts** — adapt inline, context, and summary reviews to match your team’s coding guidelines.
+- **Flexible configuration** — supports `YAML`, `JSON`, and `ENV`, with seamless overrides in CI/CD pipelines.
+- **AI Review runs fully client-side** — it never proxies or inspects your requests.
+
+AI Review runs automatically in your CI/CD pipeline and posts both **inline comments** and **summary reviews** right
+inside your merge requests. This makes reviews faster, more consistent, and less error-prone — while still leaving the
+final decision to human reviewers.
+
+---
+
+## 🧪 Live Preview
+
+Curious how **AI Review** works in practice? Here are three real Pull Requests reviewed entirely by the tool — one per
+mode:
+
+| Mode       | Description                                        | Live Example                                                                  |
+|------------|----------------------------------------------------|-------------------------------------------------------------------------------|
+| 🧩 Inline  | Adds line-by-line comments directly in the diff    | [Try AI Review (inline)](https://github.com/Nikita-Filonov/ai-review/pull/4)  |
+| 📄 Summary | Posts a concise summary review with key highlights | [Try AI Review (context)](https://github.com/Nikita-Filonov/ai-review/pull/5) |
+| 🧠 Context | Performs broader analysis across multiple files    | [Try AI Review (summary)](https://github.com/Nikita-Filonov/ai-review/pull/6) |
+
+Each review was generated automatically via GitHub Actions using the corresponding mode:
+
+```bash
+ai-review run-inline
+ai-review run-summary
+ai-review run-context
+```
+
+---
+
+## 🚀 Quick Start
+
+Install via **pip**:
+
+```bash
+pip install xai-review
+```
+
+Or run directly via Docker:
+
+```bash
+docker run --rm -v $(pwd):/app nikitafilonov/ai-review:latest run-summary
+```
+
+👉 Before running, create a basic configuration file [.ai-review.yaml](./docs/configs/.ai-review.yaml) in the root of
+your project:
+
+```yaml
+llm:
+  provider: OPENAI
+
+  meta:
+    model: gpt-4o-mini
+    max_tokens: 1200
+    temperature: 0.3
+
+  http_client:
+    timeout: 120
+    api_url: https://api.openai.com/v1
+    api_token: ${OPENAI_API_KEY}
+
+vcs:
+  provider: GITLAB
+
+  pipeline:
+    project_id: 1
+    merge_request_id: 100
+
+  http_client:
+    timeout: 120
+    api_url: https://gitlab.com
+    api_token: ${GITLAB_API_TOKEN}
+```
+
+👉 This will:
+
+- Run AI Review against your codebase.
+- Generate inline and/or summary comments (depending on the selected mode).
+- Use your chosen LLM provider (OpenAI GPT-4o-mini in this example).
+
+> **Note:** Running `ai-review run` executes the full review (inline + summary).
+> To run only one mode, use the dedicated subcommands:
+> - ai-review run-inline
+> - ai-review run-context
+> - ai-review run-summary
+
+---
+
+AI Review can be configured via `.ai-review.yaml`, `.ai-review.json`, or `.env`. See [./docs/configs](./docs/configs)
+for complete, ready-to-use examples.
+
+Key things you can customize:
+
+- **LLM provider** — OpenAI, Gemini, or Claude
+- **Model settings** — model name, temperature, max tokens
+- **VCS integration** — works out of the box with **GitLab** and **GitHub**.
+- **Review policy** — which files to include/exclude, review modes
+- **Prompts** — inline/context/summary prompt templates
+
+👉 Minimal configuration is enough to get started. Use the full reference configs if you want fine-grained control (
+timeouts, artifacts, logging, etc.).
+
+---
+
+## ⚙️ CI/CD Integration
+
+AI Review works out-of-the-box with major CI providers.
+Use these snippets to run AI Review automatically on Pull/Merge Requests.  
+Each integration uses environment variables for LLM and VCS configuration.
+
+> For full configuration details (timeouts, artifacts, logging, prompt overrides), see [./docs/configs](./docs/configs).
+
+### 🚀 GitHub Actions
+
+Add a workflow like this (manual trigger from **Actions** tab):
+
+```yaml
+name: AI Review
+on:
+  workflow_dispatch:
+    inputs:
+      review-command:
+        type: choice
+        default: run
+        options: [ run, run-inline, run-context, run-summary ]
+      pull-request-number:
+        type: string
+        required: true
+jobs:
+  ai-review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Nikita-Filonov/ai-review@v0.18.0
+        with:
+          review-command: ${{ inputs.review-command }}
+        env:
+          # --- LLM configuration ---
+          LLM__PROVIDER: "OPENAI"
+          LLM__META__MODEL: "gpt-4o-mini"
+          LLM__META__MAX_TOKENS: "15000"
+          LLM__META__TEMPERATURE: "0.3"
+          LLM__HTTP_CLIENT__API_URL: "https://api.openai.com/v1"
+          LLM__HTTP_CLIENT__API_TOKEN: ${{ secrets.OPENAI_API_KEY }}
+
+          # --- GitHub integration ---
+          VCS__PROVIDER: "GITHUB"
+          VCS__PIPELINE__OWNER: ${{ github.repository_owner }}
+          VCS__PIPELINE__REPO: ${{ github.event.repository.name }}
+          VCS__PIPELINE__PULL_NUMBER: ${{ inputs.pull-request-number }}
+          VCS__HTTP_CLIENT__API_URL: "https://api.github.com"
+          VCS__HTTP_CLIENT__API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+```
+
+🔗 Full example: [./docs/ci/github.yaml](./docs/ci/github.yaml)
+
+### 🚀 GitLab CI/CD
+
+For GitLab users:
+
+```yaml
+ai-review:
+  when: manual
+  stage: review
+  image: nikitafilonov/ai-review:latest
+  rules:
+    - if: '$CI_MERGE_REQUEST_IID'
+  script:
+    - ai-review run
+  variables:
+    # --- LLM configuration ---
+    LLM__PROVIDER: "OPENAI"
+    LLM__META__MODEL: "gpt-4o-mini"
+    LLM__META__MAX_TOKENS: "15000"
+    LLM__META__TEMPERATURE: "0.3"
+    LLM__HTTP_CLIENT__API_URL: "https://api.openai.com/v1"
+    LLM__HTTP_CLIENT__API_TOKEN: "$OPENAI_API_KEY"
+
+    # --- GitLab integration ---
+    VCS__PROVIDER: "GITLAB"
+    VCS__PIPELINE__PROJECT_ID: "$CI_PROJECT_ID"
+    VCS__PIPELINE__MERGE_REQUEST_ID: "$CI_MERGE_REQUEST_IID"
+    VCS__HTTP_CLIENT__API_URL: "$CI_SERVER_URL"
+    VCS__HTTP_CLIENT__API_TOKEN: "$CI_JOB_TOKEN"
+  allow_failure: true  # Optional: don't block pipeline if AI review fails
+
+```
+
+🔗 Full example: [./docs/ci/gitlab.yaml](./docs/ci/gitlab.yaml)
+
+---
+
+## 📘 Documentation
+
+See these folders for reference templates and full configuration options:
+
+- [./docs/ci](./docs/ci) — CI/CD integration templates (GitHub Actions, GitLab CI)
+- [./docs/configs](./docs/configs) — full configuration examples (`.yaml`, `.json`, `.env`)
+- [./docs/prompts](./docs/prompts) — prompt templates for Python/Go (light & strict modes)
+
+---
+
+## ⚠️ Privacy & Responsibility Notice
+
+AI Review does **not store**, **log**, or **transmit** your source code to any external service other than the **LLM
+provider** explicitly configured in your `.ai-review.yaml`.
+
+All data is sent **directly** from your CI/CD environment to the selected LLM API endpoint (e.g. OpenAI, Gemini,
+Claude). No intermediary servers or storage layers are involved.
+
+> ⚠️ Please ensure you use proper API tokens and avoid exposing corporate or personal secrets.
+> If you accidentally leak private code or credentials due to incorrect configuration (e.g., using a personal key
+> instead of an enterprise one), it is **your responsibility** — the tool does not retain or share any data by itself.
+
+---
+
+🧠 **AI Review** — open-source AI-powered code reviewer
+
+- 📦 [PyPI](https://pypi.org/project/xai-review/)
+- 🐳 [DockerHub](https://hub.docker.com/r/nikitafilonov/ai-review)

xai_review-0.18.0/README.md

@@ -0,0 +1,258 @@
+# AI Review
+
+AI-powered code review tool.
+
+[![CI](https://github.com/Nikita-Filonov/ai-review/actions/workflows/workflow-test.yml/badge.svg)](https://github.com/Nikita-Filonov/ai-review/actions/workflows/workflow-test.yml)
+[![codecov](https://codecov.io/gh/Nikita-Filonov/ai-review/branch/main/graph/badge.svg)](https://codecov.io/gh/Nikita-Filonov/ai-review)
+[![PyPI version](https://img.shields.io/pypi/v/xai-review.svg)](https://pypi.org/project/xai-review/)
+[![License](https://img.shields.io/github/license/Nikita-Filonov/ai-review)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/Nikita-Filonov/ai-review?style=social)](https://github.com/Nikita-Filonov/ai-review/stargazers)
+
+_Made with ❤️ by [@NikitaFilonov](https://t.me/sound_right)_
+
+---
+
+## 📑 Table of Contents
+
+- ✨ [About](#-about)
+- 🧪 [Live Preview](#-live-preview)
+- 🚀 [Quick Start](#-quick-start)
+- ⚙️ [️CI/CD Integration](#-cicd-integration)
+    - 🚀 [GitHub Actions](#-github-actions)
+    - 🚀 [GitLab CI/CD](#-gitlab-cicd)
+- 📘 [Documentation](#-documentation)
+- ⚠️ [Privacy & Responsibility Notice](#-privacy--responsibility-notice)
+
+---
+
+## ✨ About
+
+**AI Review** is a developer tool that brings **AI-powered code review** directly into your workflow. It helps teams
+improve code quality, enforce consistency, and speed up the review process.
+
+✨ Key features:
+
+- **Multiple LLM providers** — choose between **OpenAI**, **Claude**, and **Gemini**, or switch anytime.
+- **VCS integration** — works out of the box with GitLab, GitHub (more providers coming).
+- **Customizable prompts** — adapt inline, context, and summary reviews to match your team’s coding guidelines.
+- **Flexible configuration** — supports `YAML`, `JSON`, and `ENV`, with seamless overrides in CI/CD pipelines.
+- **AI Review runs fully client-side** — it never proxies or inspects your requests.
+
+AI Review runs automatically in your CI/CD pipeline and posts both **inline comments** and **summary reviews** right
+inside your merge requests. This makes reviews faster, more consistent, and less error-prone — while still leaving the
+final decision to human reviewers.
+
+---
+
+## 🧪 Live Preview
+
+Curious how **AI Review** works in practice? Here are three real Pull Requests reviewed entirely by the tool — one per
+mode:
+
+| Mode       | Description                                        | Live Example                                                                  |
+|------------|----------------------------------------------------|-------------------------------------------------------------------------------|
+| 🧩 Inline  | Adds line-by-line comments directly in the diff    | [Try AI Review (inline)](https://github.com/Nikita-Filonov/ai-review/pull/4)  |
+| 📄 Summary | Posts a concise summary review with key highlights | [Try AI Review (context)](https://github.com/Nikita-Filonov/ai-review/pull/5) |
+| 🧠 Context | Performs broader analysis across multiple files    | [Try AI Review (summary)](https://github.com/Nikita-Filonov/ai-review/pull/6) |
+
+Each review was generated automatically via GitHub Actions using the corresponding mode:
+
+```bash
+ai-review run-inline
+ai-review run-summary
+ai-review run-context
+```
+
+---
+
+## 🚀 Quick Start
+
+Install via **pip**:
+
+```bash
+pip install xai-review
+```
+
+Or run directly via Docker:
+
+```bash
+docker run --rm -v $(pwd):/app nikitafilonov/ai-review:latest run-summary
+```
+
+👉 Before running, create a basic configuration file [.ai-review.yaml](./docs/configs/.ai-review.yaml) in the root of
+your project:
+
+```yaml
+llm:
+  provider: OPENAI
+
+  meta:
+    model: gpt-4o-mini
+    max_tokens: 1200
+    temperature: 0.3
+
+  http_client:
+    timeout: 120
+    api_url: https://api.openai.com/v1
+    api_token: ${OPENAI_API_KEY}
+
+vcs:
+  provider: GITLAB
+
+  pipeline:
+    project_id: 1
+    merge_request_id: 100
+
+  http_client:
+    timeout: 120
+    api_url: https://gitlab.com
+    api_token: ${GITLAB_API_TOKEN}
+```
+
+👉 This will:
+
+- Run AI Review against your codebase.
+- Generate inline and/or summary comments (depending on the selected mode).
+- Use your chosen LLM provider (OpenAI GPT-4o-mini in this example).
+
+> **Note:** Running `ai-review run` executes the full review (inline + summary).
+> To run only one mode, use the dedicated subcommands:
+> - ai-review run-inline
+> - ai-review run-context
+> - ai-review run-summary
+
+---
+
+AI Review can be configured via `.ai-review.yaml`, `.ai-review.json`, or `.env`. See [./docs/configs](./docs/configs)
+for complete, ready-to-use examples.
+
+Key things you can customize:
+
+- **LLM provider** — OpenAI, Gemini, or Claude
+- **Model settings** — model name, temperature, max tokens
+- **VCS integration** — works out of the box with **GitLab** and **GitHub**.
+- **Review policy** — which files to include/exclude, review modes
+- **Prompts** — inline/context/summary prompt templates
+
+👉 Minimal configuration is enough to get started. Use the full reference configs if you want fine-grained control (
+timeouts, artifacts, logging, etc.).
+
+---
+
+## ⚙️ CI/CD Integration
+
+AI Review works out-of-the-box with major CI providers.
+Use these snippets to run AI Review automatically on Pull/Merge Requests.  
+Each integration uses environment variables for LLM and VCS configuration.
+
+> For full configuration details (timeouts, artifacts, logging, prompt overrides), see [./docs/configs](./docs/configs).
+
+### 🚀 GitHub Actions
+
+Add a workflow like this (manual trigger from **Actions** tab):
+
+```yaml
+name: AI Review
+on:
+  workflow_dispatch:
+    inputs:
+      review-command:
+        type: choice
+        default: run
+        options: [ run, run-inline, run-context, run-summary ]
+      pull-request-number:
+        type: string
+        required: true
+jobs:
+  ai-review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Nikita-Filonov/ai-review@v0.18.0
+        with:
+          review-command: ${{ inputs.review-command }}
+        env:
+          # --- LLM configuration ---
+          LLM__PROVIDER: "OPENAI"
+          LLM__META__MODEL: "gpt-4o-mini"
+          LLM__META__MAX_TOKENS: "15000"
+          LLM__META__TEMPERATURE: "0.3"
+          LLM__HTTP_CLIENT__API_URL: "https://api.openai.com/v1"
+          LLM__HTTP_CLIENT__API_TOKEN: ${{ secrets.OPENAI_API_KEY }}
+
+          # --- GitHub integration ---
+          VCS__PROVIDER: "GITHUB"
+          VCS__PIPELINE__OWNER: ${{ github.repository_owner }}
+          VCS__PIPELINE__REPO: ${{ github.event.repository.name }}
+          VCS__PIPELINE__PULL_NUMBER: ${{ inputs.pull-request-number }}
+          VCS__HTTP_CLIENT__API_URL: "https://api.github.com"
+          VCS__HTTP_CLIENT__API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+```
+
+🔗 Full example: [./docs/ci/github.yaml](./docs/ci/github.yaml)
+
+### 🚀 GitLab CI/CD
+
+For GitLab users:
+
+```yaml
+ai-review:
+  when: manual
+  stage: review
+  image: nikitafilonov/ai-review:latest
+  rules:
+    - if: '$CI_MERGE_REQUEST_IID'
+  script:
+    - ai-review run
+  variables:
+    # --- LLM configuration ---
+    LLM__PROVIDER: "OPENAI"
+    LLM__META__MODEL: "gpt-4o-mini"
+    LLM__META__MAX_TOKENS: "15000"
+    LLM__META__TEMPERATURE: "0.3"
+    LLM__HTTP_CLIENT__API_URL: "https://api.openai.com/v1"
+    LLM__HTTP_CLIENT__API_TOKEN: "$OPENAI_API_KEY"
+
+    # --- GitLab integration ---
+    VCS__PROVIDER: "GITLAB"
+    VCS__PIPELINE__PROJECT_ID: "$CI_PROJECT_ID"
+    VCS__PIPELINE__MERGE_REQUEST_ID: "$CI_MERGE_REQUEST_IID"
+    VCS__HTTP_CLIENT__API_URL: "$CI_SERVER_URL"
+    VCS__HTTP_CLIENT__API_TOKEN: "$CI_JOB_TOKEN"
+  allow_failure: true  # Optional: don't block pipeline if AI review fails
+
+```
+
+🔗 Full example: [./docs/ci/gitlab.yaml](./docs/ci/gitlab.yaml)
+
+---
+
+## 📘 Documentation
+
+See these folders for reference templates and full configuration options:
+
+- [./docs/ci](./docs/ci) — CI/CD integration templates (GitHub Actions, GitLab CI)
+- [./docs/configs](./docs/configs) — full configuration examples (`.yaml`, `.json`, `.env`)
+- [./docs/prompts](./docs/prompts) — prompt templates for Python/Go (light & strict modes)
+
+---
+
+## ⚠️ Privacy & Responsibility Notice
+
+AI Review does **not store**, **log**, or **transmit** your source code to any external service other than the **LLM
+provider** explicitly configured in your `.ai-review.yaml`.
+
+All data is sent **directly** from your CI/CD environment to the selected LLM API endpoint (e.g. OpenAI, Gemini,
+Claude). No intermediary servers or storage layers are involved.
+
+> ⚠️ Please ensure you use proper API tokens and avoid exposing corporate or personal secrets.
+> If you accidentally leak private code or credentials due to incorrect configuration (e.g., using a personal key
+> instead of an enterprise one), it is **your responsibility** — the tool does not retain or share any data by itself.
+
+---
+
+🧠 **AI Review** — open-source AI-powered code reviewer
+
+- 📦 [PyPI](https://pypi.org/project/xai-review/)
+- 🐳 [DockerHub](https://hub.docker.com/r/nikitafilonov/ai-review)

{xai_review-0.16.0 → xai_review-0.18.0}/ai_review/services/vcs/github/client.py

@@ -124,6 +124,10 @@ class GitHubVCSClient(VCSClient):
 
     async def create_discussion(self, file: str, line: int, message: str) -> None:
         try:
+            logger.info(
+                f"Posting inline comment in {self.owner}/{self.repo}#{self.pull_number} at {file}:{line}: {message}"
+            )
+
             pr = await self.http_client.pr.get_pull_request(
                 owner=self.owner, repo=self.repo, pull_number=self.pull_number
             )

{xai_review-0.16.0 → xai_review-0.18.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "xai-review"
 readme = "README.md"
-version = "0.16.0"
+version = "0.18.0"
 license = { text = "Apache-2.0" }
 authors = [
     { name = "Nikita Filonov", email = "nikita.filonov@example.com" }