How hikariming/ghfind works
ghfind is a GitHub developer scoring and discovery platform, with a web app, public API/MCP/SDK surfaces, personalized feed, and a GitHub App that labels incoming issues and pull requests. The main user path is a browser request to scan a GitHub profile, fetch public GitHub data, compute a score, and display discovery/profile results; roast generation is a separate LLM-assisted path. The README documents these capabilities, while source excerpts show selected route wiring. Several runtime and data-layer connections are therefore omitted rather than inferred.
Main entry points: scan/route.ts Profile scan API · mcp/route.ts MCP tools · [username]/route.ts Score endpoint · github.ts GitHub data collection
Components 22
Scoring and assessment
- Profile scan API
src/app/api/scan/route.ts - GitHub data collection
src/lib/github.ts - Deterministic scoring
src/lib - Roast generation
src/app/api/roast/route.ts - LLM integration
src/lib/llm.ts - Profile and score storage
src/lib/db.ts
Discovery and profiles
- Developer discovery
src/app/api/developers/route.ts - Leaderboard
src/app/api/leaderboard/route.ts - Developer profiles
src/app/[locale]/u/[username]/page.tsx - Profile cards and badges
src/app/api/card/[username]/route.tsx
Web and developer interfaces
- Web experience
src/app/[locale]/page.tsx - Score endpoint
src/app/api/score/[username]/route.ts - MCP tools
src/app/mcp/route.ts - JavaScript SDK
packages/ghfind-js/src/client.ts - Python SDK
packages/ghfind-py/ghfind/client.py
Personalized feed
- Feed API
cmd/ghfind-api/main.go - Feed runtime
platform/runtime/src/router.ts - Feed data store
platform/feed/src/store.ts
GitHub issue review
- GitHub Review App
platform/github-app/src/review.ts
Other components
- Developer
- GitHub
- LLM provider
Connections 22
- Developer → Web experience: uses
README.md - Web experience → Profile scan API: requests scan
README.md - Profile scan API → GitHub data collection: fetches profile
README.md - GitHub data collection → GitHub: reads public data
README.md - Profile scan API → Deterministic scoring: scores metrics
README.md - Profile scan API → Profile and score storage: caches result
README.md - Developer → Roast generation: requests roast
README.md - Roast generation → LLM integration: generates report
src/app/api/roast/route.ts - LLM integration → LLM provider: calls provider
README.md - Developer → Score endpoint: requests score
README.md - Developer → Developer discovery: finds developers
README.md - Developer → Leaderboard: browses rankings
README.md - Developer → Developer profiles: views profile
README.md - Developer profiles → Profile cards and badges: shares identity
README.md - Developer → MCP tools: uses agent tools
README.md - MCP tools → Developer discovery: searches developers
src/app/mcp/route.ts - MCP tools → Leaderboard: gets leaderboard
src/app/mcp/route.ts - JavaScript SDK → Score endpoint: calls API
README.md - Python SDK → Score endpoint: calls API
README.md - Feed API → Feed runtime: configures feed
cmd/ghfind-api/main.go - Feed runtime → Feed data store: uses storage
- GitHub Review App → GitHub: labels issues
README.md