RepoRadar

RepoRadar is a local-first, no-login GitHub signal dashboard. It helps you choose topics you care about, scan public GitHub repositories, rank what looks worth watching, and read plain-English summaries of what each repository does.

It is designed to be safe to run locally and safe to make public later. There are no user accounts, no telemetry, no shared database, and no required API keys.

Screenshots

Topic selection, transparent scoring, and a ranked repository digest:

Expand any repository for a plain-English summary and the reasons it surfaced:

What it does

• Lets you toggle interest areas such as AI agents, LLMs, developer tools, Next.js, Python, robotics, data, and security.
• Shows a ranked repository digest using transparent scoring.
• Works immediately in demo mode using local seed data.
• Can optionally scan GitHub's official public API.
• Can optionally generate AI-assisted summaries if you configure your own Anthropic API key locally.
• Falls back safely if GitHub is unavailable, rate-limited, or no API key is configured.

What it does not do

RepoRadar does not require login, collect user data, track analytics, clone arbitrary repositories, execute fetched code, or store secrets in the browser.

Quick start

Install dependencies:

npm install

Run the local app:

npm run dev

Open the local URL printed by Next.js, usually http://localhost:3000.

Demo mode works without any API keys.

Run with Docker

RepoRadar ships a multi-stage Dockerfile that produces a small, self-contained image running as a non-root user. No database is required.

Build the image:

docker build -t reporadar .

Run it and open http://localhost:3000:

docker run --rm -p 3000:3000 reporadar

Demo mode works with no configuration. To enable live GitHub mode or AI summaries, pass your local environment file (never bake keys into the image):

docker run --rm -p 3000:3000 --env-file .env.local reporadar

Optional live GitHub mode

GitHub's public API can be used without a token, but rate limits are lower. For better local use, create a GitHub token with public repository read access only, then copy .env.example to .env.local and set:

GITHUB_TOKEN=your_token_here

Never commit .env.local. This repository's .gitignore excludes it.

Optional AI summaries

RepoRadar works without AI keys. If you want AI-assisted summaries, set your own Anthropic key in .env.local:

ANTHROPIC_API_KEY=your_key_here
ANTHROPIC_MODEL=claude-3-5-haiku-20241022

External repository metadata is treated as untrusted data. RepoRadar sends only bounded metadata to the model, validates the response shape, and falls back to deterministic summaries if AI output is unavailable or invalid.

Safety model

RepoRadar is local-first. Topic preferences are stored only in browser localStorage. API keys stay in local environment files. The app does not ask users to paste secrets into the UI.

All GitHub content is treated as untrusted. The MVP does not clone repos, run code from repos, or use fetched text as instructions.

Scripts

npm run dev
npm run test
npm run typecheck
npm run lint
npm run build

Current status

This is an MVP intended to prove the product locally first. Historical star velocity and saved archives are planned for a later phase, likely with a small local SQLite database.

Licence

MIT. See LICENSE.