How syed-waleed-hussain/knowledgepilot-ai works
KnowledgePilot AI is a local course-PDF study workspace with a separate research workflow. The principal study path is course/document management, PDF ingestion and retrieval, then evidence-grounded chat answers with references; users reach it through the React app and authenticated API. Research adds topic discovery, paper saving and notes, and AI analysis. Edges use the README, source-index references, or excerpts; unsampled implementation details are omitted or shown only as unverified links.
Main entry points: app.py FastAPI routes · App.jsx React application · agent_harness.py Chat workflow · research_graph.py Paper discovery
Components 24
Web workspace
- React application
frontend/src/App.jsx - Course pages
frontend/src/pages/Workspace.jsx - Research page
frontend/src/pages/Research.jsx - API client
frontend/src/services/api.js - Auth client
frontend/src/services/auth.js - Answer display
frontend/src/components/MarkdownAnswer.jsx - PDF report export
frontend/src/services/researchPdf.js
Course study
- FastAPI routes
backend/app.py - PDF ingestion
pdf_processor.py - Vector retrieval
rag_engine.py - Chat workflow
backend/agent_harness.py - Answer generation
llm_service.py - Infographics
backend/infographic.py
Research workspace
- Research routes
backend/research_api.py - Paper discovery
backend/research_graph.py - Research providers
backend/research_providers.py - Research quality
backend/research_quality.py - Research records
backend/research_store.py
Local data
- Course and chat data
backend/course_store.py
External services
- Supabase auth
backend/supabase_auth.py - Groq LLM
- Supabase
- Public paper APIs
Other components
- Student
Connections 29
- Student → React application: uses
README.md - React application → Course pages: routes to
frontend/src/App.jsx - React application → Research page: routes to
frontend/src/App.jsx - React application → Auth client: restores session
frontend/src/App.jsx - Course pages → API client: requests data
frontend/src/pages/Workspace.jsx - Research page → Answer display: renders answers
frontend/src/pages/Research.jsx - Research page → PDF report export: exports reports
frontend/src/pages/Research.jsx - API client → FastAPI routes: calls API
- Auth client → Supabase: authenticates
- FastAPI routes → Course and chat data: reads and writes
backend/app.py - FastAPI routes → PDF ingestion: processes PDFs
backend/app.py - FastAPI routes → Vector retrieval: retrieves evidence
backend/app.py - FastAPI routes → Chat workflow: handles chat
backend/app.py - Chat workflow → Course and chat data: loads records
backend/agent_harness.py - Chat workflow → Vector retrieval: retrieves evidence
- Chat workflow → Answer generation: generates answer
README.md - Answer generation → Groq LLM: requests completion
llm_service.py - FastAPI routes → Infographics: serves infographic
backend/app.py - FastAPI routes → Supabase auth: checks identity
backend/app.py - Supabase auth → Supabase: verifies user
backend/supabase_auth.py - FastAPI routes → Research routes: mounts routes
backend/app.py - Research routes → Paper discovery: invokes discovery
backend/research_api.py - Research routes → Research records: stores research
backend/research_api.py - Paper discovery → Research providers: searches providers
backend/research_graph.py - Paper discovery → Research records: loads records
backend/research_graph.py - Paper discovery → Research quality: checks quality
backend/research_graph.py - Research providers → Course and chat data: uses SQLite
backend/research_providers.py - Research providers → Public paper APIs: searches papers
backend/research_providers.py - Research records → Course and chat data: persists records
backend/research_store.py