Skip to main content

AI-powered code review tool for Git repositories

Project description

AIReview

PyPI Changelog Tests codecov License

AIReview is a command-line tool that leverages LLM to provide code reviews for your Git changes.

Features

  • Automatic detection of Git changes
  • AI-powered code review using OpenAI's GPT models
  • Customizable review prompts and project context
  • Markdown-formatted review output
  • Support for multiple file reviews in a single run

Installation

  1. Clone the repository:
git clone https://github.com/setkyar/aireview.git
cd aireview
  1. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install the package:
pip install -e .

Configuration

Create a configuration file named aireview.config with the following structure:

[ai]
model = gpt-4
api_key = your_openai_api_key
base_url = https://api.openai.com/v1  # Optional: for custom OpenAI-compatible endpoints

[review]
output = ai-review.md # Output file for the review comments

[context]
project_context = Your project context description... # Example, I am working on Nodejs, typescript project

[prompt]
prompt_template = Your custom review prompt... # Example, Review the changes and provide feedback on the code quality and best practices

Usage

  1. Make some changes in your Git repository
  2. Add changes to the staging area:
git add  the/changed/files
  1. Run AIReview:
aireview --config path/to/aireview.config

The tool will:

  1. Detect your Git changes
  2. Send them to the LLM for review
  3. Generate a markdown file with the review comments

Development

Running Tests

# Install test dependencies
pip install -e ".[test]"

# Run tests
pytest

# Run tests with coverage
coverage run -m pytest
coverage report

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aireview-1.3.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aireview-1.3-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file aireview-1.3.tar.gz.

File metadata

  • Download URL: aireview-1.3.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for aireview-1.3.tar.gz
Algorithm Hash digest
SHA256 d4b2203e19ffa7939cd2784dd123a9df363d083d14e763ece2d54650a8c254b2
MD5 d3f6d71ff62550ba06d976e9da12734d
BLAKE2b-256 1337dc65579471b2683a953b2480de2d1cfd04895e0149b9eee465e03bdbe36d

See more details on using hashes here.

File details

Details for the file aireview-1.3-py3-none-any.whl.

File metadata

  • Download URL: aireview-1.3-py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for aireview-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a9d5f7ebe335a32bb5da2350a994e7d2199e951bb81e331729e6210a79bb0fc4
MD5 35c69f03acc316820121f16095715e8c
BLAKE2b-256 8c6bec81b8094fee18cd753ec342fd1d786b047921132a5f1beb07d50a28eae6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page