Repo Research

Quick start

Install dependencies:

uv sync

Run the pulse command (see Configuration first for required env vars):

uv run repo-research pulse

--help on any command lists its flags; the full reference lives in docs/cli.md.

Configuration

Required:

• GITHUB_TOKEN — a (fine-grained) GitHub personal access token with public_repo scope (or repo if you want private repos in your analysis).

LLM provider — pick one via LLM_PROVIDER:

• ollama (default) — runs locally. Install Ollama, pull a tool-calling-capable model (e.g. ollama pull qwen3:8b), and run ollama serve. Override the endpoint with OLLAMA_BASE_URL (default http://localhost:11434). Falls back to Anthropic if Ollama is unreachable and ANTHROPIC_API_KEY is set.
• anthropic — set ANTHROPIC_API_KEY from console.anthropic.com.
• huggingface — set HUGGINGFACE_API_KEY from huggingface.co/settings/tokens. Default model: Qwen/Qwen2.5-7B-Instruct.

Drop these in a .env at the project root — python-dotenv picks them up automatically. Example:

GITHUB_TOKEN=ghp_...
LLM_PROVIDER=ollama
# OLLAMA_BASE_URL=http://localhost:11434
# ANTHROPIC_API_KEY=sk-ant-...
# HUGGINGFACE_API_KEY=hf_...

Optional: tracing via LangSmith is supported out of the box — see Observability and traces (LangSmith) for the env vars to set.

If something isn't wired up correctly, run uv run repo-research diagnostics to surface provider/auth issues.

Commands

• diagnostics — Diagnose issues with the setup
• pulse — Analyze activity of user's starred repositories
• topics — Search for repositories related to specific topics/with specific labels
• hotspots — Analyze maintenance hotspots in a repository
• history — List recent conversation history
• show — Display full conversation transcript
• chat — Start a new interactive chat session
• resume — Resume an existing conversation interactively
• ui — Launch the Gradio web UI

See docs/cli.md for the full reference (arguments, flags, defaults).

Development

Working on the project itself? See docs/development.md for setup, pre-commit hooks, linting, regenerating CLI docs, and LangSmith observability.

License

Apache 2.0 — see LICENSE.