How laibaparvaiz/techmate works
TechMate is a Streamlit multi-agent study and coding assistant. A user message enters the supervisor, which handles pending confirmations or routes the request to a study, mentor, or coding specialist; the response is returned through the UI. Study answers can use uploaded-document retrieval, grading, web fallback, and verification. Write-capable actions are proposed before execution. The graph preserves documented capabilities even where implementation was not sampled; those links cite the README rather than implying source inspection.
Main entry points: supervisor.py Supervisor graph · study_agent.py Study agent · streaming.py Streamlit interface · coding_agent.py Coding agent
Components 25
Conversation and routing
- Streamlit interface
app/ui/streaming.py - Supervisor graph
app/agents/supervisor.py
Specialist agents
- Study agent
app/agents/study_agent.py - Mentor agent
app/agents/mentor_agent.py - Coding agent
app/agents/coding_agent.py - Conversation summarizer
app/agents/summarizer.py
Study and retrieval
- Study tools
app/tools/study_tools.py - Document ingestion
app/rag/ingestion.py - FAISS index
app/rag/ingestion.py - Chunk retrieval
app/rag/retrieval.py - Web search
app/tools/web_search.py
Tools and safeguards
- Code tools
app/tools/code_tools.py - PDF tools
app/tools/pdf_tools.py - System tools
app/tools/system_tools.py - Pending actions
app/safety/hitl.py - Path permissions
app/safety/permissions.py - Privacy redaction
app/safety/privacy.py
Memory and providers
- Conversation memory
app/memory/memory.py - Weak-area tracking
app/memory/skills.py - PostgreSQL state
app/database/models.py - Session records
app/sessions.py - LLM fallback router
app/utils/llm_router.py - Context budgeting
app/utils/context_budget.py - Runtime configuration
app/config.py
Other components
- User
Connections 40
- User → Streamlit interface: sends message
README.md - Streamlit interface → Supervisor graph: submits turn
app/ui/streaming.py - Streamlit interface → Document ingestion: indexes upload
app/ui/streaming.py - Supervisor graph → Study agent: routes study
app/agents/supervisor.py - Supervisor graph → Mentor agent: routes mentor
app/agents/supervisor.py - Supervisor graph → Coding agent: routes coding
app/agents/supervisor.py - Supervisor graph → Pending actions: checks action
app/agents/supervisor.py - Supervisor graph → Conversation summarizer: compresses history
app/agents/supervisor.py - Supervisor graph → Weak-area tracking: loads weaknesses
app/agents/supervisor.py - Supervisor graph → Privacy redaction: redacts responses
app/agents/supervisor.py - Study agent → Chunk retrieval: retrieves context
app/agents/study_agent.py - Study agent → Study tools: uses study tools
app/agents/study_agent.py - Study agent → Web search: falls back web
README.md - Study agent → LLM fallback router: invokes models
app/agents/study_agent.py - Study agent → Context budgeting: caps context
app/agents/study_agent.py - Chunk retrieval → FAISS index: searches index
app/rag/retrieval.py - Document ingestion → FAISS index: writes index
app/rag/ingestion.py - Mentor agent → Code tools: uses tools
app/agents/mentor_agent.py - Mentor agent → System tools: uses tools
app/agents/mentor_agent.py - Mentor agent → LLM fallback router: invokes models
app/agents/mentor_agent.py - Coding agent → Code tools: uses tools
app/agents/coding_agent.py - Coding agent → System tools: uses tools
app/agents/coding_agent.py - Coding agent → PDF tools: uses PDF tools
app/agents/coding_agent.py - Coding agent → LLM fallback router: invokes models
app/agents/coding_agent.py - Code tools → Path permissions: validates paths
app/tools/code_tools.py - Code tools → Pending actions: registers proposals
app/tools/code_tools.py - Code tools → Privacy redaction: redacts content
app/tools/code_tools.py - PDF tools → Path permissions: validates paths
app/tools/pdf_tools.py - PDF tools → Pending actions: registers proposals
app/tools/pdf_tools.py - Study tools → Path permissions: checks permissions
app/tools/study_tools.py - Study tools → Pending actions: registers proposals
app/tools/study_tools.py - System tools → Path permissions: checks permissions
app/tools/system_tools.py - Conversation memory → PostgreSQL state: checkpoints state
README.md - Conversation summarizer → LLM fallback router: invokes models
app/agents/summarizer.py - Weak-area tracking → PostgreSQL state: stores weak areas
app/memory/skills.py - Session records → PostgreSQL state: stores sessions
app/sessions.py - Streamlit interface → Conversation memory: loads memory
app/ui/streaming.py - Streamlit interface → Session records: manages sessions
app/ui/streaming.py - LLM fallback router → Runtime configuration: reads providers
app/utils/llm_router.py - PostgreSQL state → Runtime configuration: reads database settings
app/database/models.py