A GitHub bot that performs AI-assisted code reviews by analyzing diffs and providing intelligent comments.

• Receives GitHub webhook events for pull requests
• Analyzes code diffs using AI
• Posts review comments back to GitHub
• Built with FastAPI for high performance
• Async/await support for efficient processing

• Python 3.11+
• Poetry (install from https://python-poetry.org/docs/#installation)
• GitHub account and repository access

1. Install dependencies:

poetry install

2. Configure your settings:

cp .env.example .env
# Edit .env with your GitHub token and AI API keys

Start the development server:

poetry run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Or use the Poetry script:

poetry run start

poetry run pytest

Format code:

poetry run black app/ tests/

Lint code:

poetry run flake8 app/ tests/
poetry run mypy app/

Set these environment variables in your .env file:

• GITHUB_TOKEN: Your GitHub personal access token
• GITHUB_WEBHOOK_SECRET: Secret for validating GitHub webhooks
• AI_API_KEY: API key for your AI service (e.g., OpenAI)
• AI_MODEL: AI model to use (e.g., gpt-4)
• AI_BASE_URL: (Optional) Custom base URL for OpenAI-compatible APIs (e.g., Azure OpenAI, LocalAI, Ollama)
  • If not set, defaults to OpenAI's official API endpoint
  • Example for Azure: https://YOUR-RESOURCE.openai.azure.com/v1
  • Example for LocalAI: http://localhost:8080/v1

• app/main.py: FastAPI application entry point
• app/api/: API endpoints
• app/services/: Business logic (GitHub integration, AI analysis)
• app/config.py: Configuration management
• tests/: Test suite

1. Go to your repository settings → Webhooks
2. Add webhook with URL: https://your-domain.com/webhooks/github
3. Select events: Pull requests
4. Set the webhook secret matching your GITHUB_WEBHOOK_SECRET

MIT