LlamaDiff

A Python-based code review tool that analyzes git diffs between branches using LLMs.

License

Licensed under the Apache License, Version 2.0.

Features

• Compare any two git branches and get AI-powered code review
• Supports multiple LLM providers via litellm:
  • Ollama (local, default)
  • OpenAI (GPT-4, GPT-4o, etc.)
  • Anthropic (Claude)
  • OpenRouter (access to many models)

Installation

Via pipx (recommended)

# Run directly without installing
pipx run llama-diff -s feature -t main

# Or install globally
pipx install llama-diff

Via pip

pip install llama-diff

From source

git clone https://github.com/ernestp/LlamaDiff.git
cd LlamaDiff
pip install -e .

Configuration

Copy .env.example to .env and configure your preferred provider:

cp .env.example .env

Usage

# Basic usage (compare current branch to main)
llama-diff --source feature-branch --target main

# Using a specific model
llama-diff -s feature -t main --model ollama/codellama

# Using OpenAI
llama-diff -s feature -t main --model gpt-4o

# Review specific files only
llama-diff -s feature -t main --files "*.py"

# Output to file
llama-diff -s feature -t main --output review.md

# Interactive HTML review
llama-diff -s feature -t main --html

# Review uncommitted changes
llama-diff --uncommitted

Model Examples