Skip to main content

Upsilon

AI-powered code review for pre-commit hooks using Claude

🤖 AI-Powered Reviews

Uses Anthropic's Claude for intelligent code analysis with context-aware feedback that understands your code's intent and structure.

🛠️ External Tool Integration

Seamlessly integrates with mypy, ruff, compilers, and other development tools for comprehensive analysis using proven tools.

🌍 Multi-Language Support

Supports Python, JavaScript, TypeScript, Go, Rust, C++, Julia, and more with language-specific analysis and tooling.

⚙️ Highly Configurable

Customize rules, tools, prompts, and language settings to fit your workflow with flexible TOML-based configuration.

🔧 Pre-commit Integration

Works seamlessly with pre-commit hooks and CI/CD pipelines for automatic quality gates and continuous integration.

📊 Rich Output

Beautiful CLI output with detailed issue reporting, multiple formats, and comprehensive feedback for developers.

Quick Example

# Install Upsilon
pip install upsilon

# Review your code
upsilon review src/*.py --verbose

# Integrate with pre-commit
echo "
repos:
  - repo: https://github.com/user/upsilon
    rev: v1.0.0
    hooks:
      - id: upsilon
" >> .pre-commit-config.yaml

Architecture Overview

Upsilon follows a modular, composable architecture that combines AI-powered analysis with real compiler and linter feedback.

  • Core Reviewer: Orchestrates the review process
  • Tool System: Pluggable analysis tools (built-in + external)
  • LLM Integration: Claude API with function calling
  • Configuration: Flexible TOML-based configuration

See the full architecture documentation for detailed diagrams.