How zayn329/chimeraai works
Chimera is an academic assistant that routes student questions to tutoring, exam-strategy, or administrative-policy specialists and returns grounded answers. The main runtime path is the browser UI through the gateway to the API, which checks its semantic cache before invoking the multi-agent workflow; agents can call retrieval tools before producing a response. Knowledge ingestion populates Pinecone, while MongoDB backs workflow checkpointing. The tree and excerpts support the backend flow, but do not show the frontend request implementation or the retrieval-tool internals, so those links are limited accordingly.
Main entry points: orchestrator.py Swarm orchestrator · server.py Chat API · tools.py Retrieval tools · semantic_cache.py Semantic cache
Components 18
Student experience
- Web interface
chimera-frontend/src/pages/LandingPage.jsx
API and routing
- Chat gateway
chimera-gateway/index.js - Chat API
chimera_backend/server.py - Semantic cache
chimera_backend/semantic_cache.py - Circuit breaker
chimera_backend/server.py
Agent workflow
- Swarm orchestrator
chimera_backend/orchestrator.py - Intent router
chimera_backend/orchestrator.py - Tutor worker
chimera_backend/orchestrator.py - Strategist worker
chimera_backend/orchestrator.py - Policy worker
chimera_backend/orchestrator.py - Tool dispatcher
chimera_backend/orchestrator.py
Knowledge and state
- Retrieval tools
chimera_backend/tools.py - Pinecone vectors
- Knowledge ingestion
chimera_backend/cloud_ingest.py - Workflow checkpoints
Other components
- Student
- Gemini model
- Web search
Connections 22
- Student → Web interface: submits query
- Chat gateway → Chat API: proxies stream
- Chat API → Semantic cache: checks cache
- Chat API → Circuit breaker: checks status
- Chat API → Swarm orchestrator: invokes on miss
- Chat API → Semantic cache: stores answer
- Swarm orchestrator → Intent router: classifies intent
- Intent router → Gemini model: requests decision
- Swarm orchestrator → Tutor worker: dispatches
- Swarm orchestrator → Strategist worker: dispatches
- Swarm orchestrator → Policy worker: dispatches
- Tutor worker → Gemini model: requests response
- Strategist worker → Gemini model: requests response
- Policy worker → Gemini model: requests response
- Tutor worker → Tool dispatcher: requests tools
- Strategist worker → Tool dispatcher: requests tools
- Policy worker → Tool dispatcher: requests tools
- Tool dispatcher → Retrieval tools: executes calls
- Retrieval tools → Pinecone vectors: searches knowledge
- Retrieval tools → Web search: searches web
- Knowledge ingestion → Pinecone vectors: uploads vectors
- Swarm orchestrator → Workflow checkpoints: saves checkpoints