How ashfak99/contribpilot works
ContribPilot helps contributors find suitable GitHub issues, investigate an issue with repository-grounded AI context, and request progressive hints. The main flow runs from the React matchmaker through the API client and FastAPI issue routes into the AI service; issue discovery and breakdown use GitHub data, while ranking, breakdown, and hints use Groq. BYOK credentials and match/hint progress are handled in browser storage. The graph preserves the documented capabilities; several backend internals and auxiliary pages were not sampled, so their runtime connections are omitted.
Main entry points: ai_service.py AI orchestration · api.js API client · llm_client.py Groq client · main.py FastAPI app
Components 21
Contributor app
- App routing
frontend/src/App.jsx - Issue matchmaker
frontend/src/pages/Matchmaker.jsx - Issue details
frontend/src/pages/IssueDetails.jsx - Progressive hints
frontend/src/components/HintCard.jsx - Key configuration
frontend/src/pages/Config.jsx - Browser state
frontend/src/utils/sessions.js - API client
frontend/src/services/api.js
API and orchestration
- FastAPI app
backend/app/main.py - Issue routes
backend/app/api/issues.py - Hint route
backend/app/api/contributions.py - AI orchestration
backend/app/services/ai_service.py - Request models
backend/app/schemas/request.py - AI response models
backend/app/schemas/ai.py
Repository context
- GitHub data access
backend/app/services/github_service.py
AI guidance
- Issue ranking
backend/app/ai/ranking.py - Issue breakdown
backend/app/ai/breakdown.py - Hint generation
backend/app/ai/hints.py - Groq client
backend/app/ai/llm_client.py
Other components
- Contributor
- GitHub REST API
- Groq API
Connections 27
- Contributor → Issue matchmaker: sets profile
- Contributor → Key configuration: supplies keys
README.md - App routing → Issue matchmaker: routes to
frontend/src/App.jsx - App routing → Issue details: routes to
frontend/src/App.jsx - Issue matchmaker → API client: requests matches
frontend/src/pages/Matchmaker.jsx - Issue details → API client: requests breakdown
frontend/src/pages/IssueDetails.jsx - Progressive hints → API client: requests hint
frontend/src/components/HintCard.jsx - Key configuration → Browser state: stores credentials
frontend/src/pages/Config.jsx - API client → Browser state: reads credentials
frontend/src/services/api.js - Browser state → API client: adds request headers
frontend/src/services/api.js - API client → FastAPI app: posts requests
frontend/src/services/api.js - FastAPI app → Issue routes: registers routes
backend/app/main.py - FastAPI app → Hint route: registers routes
backend/app/main.py - Issue routes → AI orchestration: delegates
backend/app/api/issues.py - Hint route → AI orchestration: delegates
backend/app/api/contributions.py - Issue routes → Request models: uses request types
backend/app/api/issues.py - AI orchestration → GitHub data access: fetches issue context
backend/app/services/ai_service.py - GitHub data access → GitHub REST API: requests repository data
README.md - AI orchestration → Issue ranking: ranks issues
backend/app/services/ai_service.py - AI orchestration → Issue breakdown: builds breakdown
backend/app/services/ai_service.py - AI orchestration → Hint generation: generates hints
backend/app/services/ai_service.py - Issue ranking → Groq client: requests completion
backend/app/ai/ranking.py - Issue breakdown → Groq client: requests completion
backend/app/ai/breakdown.py - Hint generation → Groq client: requests completion
backend/app/ai/hints.py - Groq client → Groq API: calls completions
backend/app/ai/llm_client.py - AI orchestration → AI response models: returns typed results
backend/app/services/ai_service.py - Hint route → AI response models: declares response
backend/app/api/contributions.py