https://github.com/andrewadev/repo-research
Agentic flows for discovering and exploring repos.
https://github.com/andrewadev/repo-research
ag-ui ai ai-agents analysis github
Last synced: 12 days ago
JSON representation
Agentic flows for discovering and exploring repos.
- Host: GitHub
- URL: https://github.com/andrewadev/repo-research
- Owner: AndrewADev
- License: apache-2.0
- Created: 2025-01-10T20:25:31.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-07T15:02:11.000Z (24 days ago)
- Last Synced: 2026-06-07T16:22:20.307Z (23 days ago)
- Topics: ag-ui, ai, ai-agents, analysis, github
- Language: Python
- Homepage:
- Size: 396 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Repo Research
## Quick start
Install dependencies:
```shell
uv sync
```
Run the `pulse` command (see [Configuration](#configuration) first for required env vars):
```shell
uv run repo-research pulse
```
`--help` on any command lists its flags; the full reference lives in [docs/cli.md](docs/cli.md).
## Configuration
Required:
- `GITHUB_TOKEN` — a [(fine-grained) GitHub personal access token](https://github.com/settings/tokens) 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](https://ollama.com/), 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](https://console.anthropic.com/).
- `huggingface` — set `HUGGINGFACE_API_KEY` from [huggingface.co/settings/tokens](https://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:
```dotenv
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)](docs/development.md#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](docs/cli.md) for the full reference (arguments, flags, defaults).
## Development
Working on the project itself? See [docs/development.md](docs/development.md) for setup, pre-commit hooks, linting, regenerating CLI docs, and LangSmith observability.
## License
Apache 2.0 — see [LICENSE](LICENSE).