How arul-ananth/open-source-assist works
Open Source Assist is a repository-discovery and open-source learning platform. Users explore projects through semantic search and GitHub-backed discovery, then use learning, assessment, and roadmap features alongside community tools; accounts support personalized and administrative workflows. The README documents local embeddings, Qdrant retrieval, popularity-aware ranking, and extensible scoring. The source index confirms several route-to-service and service-to-service references, but many feature implementations were not excerpted; their nodes are retained from the repository tree and uncertain connections are omitted.
Main entry points: main.py API application · search_service.py Search orchestration · embedding_service.py Text embeddings · auth_service.py Account workflows
Components 29
User experience
- Web application
frontend/src/App.tsx - Dashboard
frontend/src/page/DashboardPage.tsx - Roadmap views
frontend/src/components/roadmap/RoadmapPage.tsx - Authentication dialog
frontend/src/components/shared/AuthDialog.tsx
API workflows
- API application
backend/main.py - Authentication routes
backend/api/auth.py - Search routes
backend/api/routes/search.py - GitHub routes
backend/api/routes/github.py - Learning routes
backend/api/routes/learning.py - Assessment routes
backend/api/routes/assessment.py - Roadmap routes
backend/api/routes/roadmaps.py - Community routes
backend/api/routes/forum.py
Repository discovery
- Search orchestration
backend/services/search_service.py - Text embeddings
backend/services/embedding_service.py - Vector index
backend/services/qdrant_service.py - Ranking strategy
backend/services/scoring_strategy.py - GitHub discovery
backend/services/github_service.py - GitHub API client
backend/services/github_client.py
Learning and community
- Learning assistant
backend/services/learning_agent.py - Skill assessment
backend/services/assessment_service.py - Roadmap planning
backend/services/roadmap_service.py - Documentation explorer
backend/services/doc_service.py - Chatbot
backend/services/chatbot_agent.py - Forum service
backend/services/forum_service.py
Platform services
- Account workflows
backend/services/auth_service.py - User records
backend/models/user_model.py - PostgreSQL sessions
backend/core/database.py - Runtime configuration
backend/core/config.py
Other components
- User
Connections 26
- User → Web application: uses
- Web application → API application: calls API
- API application → Authentication routes: registers
backend/main.py - API application → Search routes: registers
backend/main.py - API application → Learning routes: registers
backend/main.py - API application → Assessment routes: registers
backend/main.py - API application → Roadmap routes: registers
backend/main.py - API application → Community routes: registers
backend/main.py - Search routes → Search orchestration: delegates to
backend/api/routes/search.py - Search orchestration → Text embeddings: embeds queries
backend/services/search_service.py - Search orchestration → Vector index: retrieves vectors
backend/services/search_service.py - Search orchestration → Ranking strategy: scores results
backend/services/search_service.py - Search orchestration → GitHub API client: fetches candidates
backend/services/search_service.py - Text embeddings → Runtime configuration: loads settings
backend/services/embedding_service.py - Text embeddings → Vector index: provides vectors
backend/services/qdrant_service.py - GitHub routes → GitHub discovery: delegates to
backend/api/routes/github.py - GitHub routes → GitHub API client: uses client
backend/api/routes/github.py - Authentication routes → Account workflows: delegates to
backend/api/auth.py - Account workflows → User records: reads and writes
backend/services/auth_service.py - Account workflows → PostgreSQL sessions: uses session
- Assessment routes → Skill assessment: delegates to
backend/api/routes/assessment.py - Roadmap routes → Roadmap planning: delegates to
backend/api/routes/roadmaps.py - Community routes → Forum service: delegates to
backend/api/routes/forum.py - Learning routes → Learning assistant: delegates to
- API application → Vector index: checks collection
backend/main.py - API application → PostgreSQL sessions: initializes
backend/main.py