How mrxtheanon/campus_os works
CampusOS is a FastAPI-backed autonomous campus assistant. A student submits a natural-language request; the chat route hands it to the master agent, which classifies and plans work, dispatches specialist agents, and returns their results. The specialist branches cover campus Q&A, events, lab equipment, grievances, reminders, document generation, and library research. Shared infrastructure provides language-model access, campus knowledge retrieval, persistence, scheduling, proactive monitoring, and learning from interactions. The README and sampled files establish these capabilities; unsampled module internals are represented only where their wiring is documented.
Main entry points: master_agent.py Master agent · database.py Campus database · llm_manager.py LLM manager · student_support.py Student support
Components 21
Request orchestration
- Chat API
backend/app/api/chat.py - Master agent
backend/app/agents/master_agent.py - Task planner
backend/app/core/task_planner.py - Intent patterns
backend/app/utils/nlp_patterns.py
Specialist services
- Student support
backend/app/agents/student_support.py - Event operations
backend/app/agents/event_operations.py - Lab assistance
backend/app/agents/lab_assistance.py - Grievance routing
backend/app/agents/grievance_routing.py - Reminder agent
backend/app/agents/reminder_agent.py - Document generator
backend/app/agents/document_generator.py - Library research
backend/app/agents/library_research.py
AI and knowledge
- LLM manager
backend/app/core/llm_manager.py - Vector retrieval
backend/app/core/vector_store.py - Research scraper
backend/app/scrapers/research_scraper.py
Campus operations
- Campus database
backend/app/core/database.py - Domain models
backend/app/models/base.py - Reminder scheduler
backend/app/core/scheduler.py
Monitoring and learning
- Campus monitor
backend/app/core/campus_monitor.py - Learning engine
backend/app/core/learning_engine.py - Self-learning
backend/app/core/self_learning_engine.py
Other components
- Student
Connections 28
- Student → Chat API: submits query
- Chat API → Master agent: forwards request
- Master agent → Intent patterns: classifies intent
- Master agent → Task planner: plans tasks
- Master agent → Student support: dispatches
- Master agent → Event operations: dispatches
- Master agent → Lab assistance: dispatches
- Master agent → Grievance routing: dispatches
- Master agent → Reminder agent: dispatches
- Master agent → Document generator: dispatches
- Master agent → Library research: dispatches
- Master agent → Chat API: returns response
- Student support → Vector retrieval: retrieves knowledge
- Student support → LLM manager: generates answer
- Library research → Research scraper: searches papers
- Library research → LLM manager: summarizes results
- Event operations → Campus database: reads and writes
- Lab assistance → Campus database: reads and writes
- Grievance routing → Campus database: stores tickets
- Grievance routing → Reminder scheduler: schedules escalation
- Reminder agent → Reminder scheduler: schedules reminders
- Document generator → LLM manager: generates content
- Campus database → Domain models: maps domain records
- Campus monitor → Campus database: checks campus state
- Master agent → Learning engine: updates interaction learning
- Learning engine → Campus database: persists memory
- Self-learning → Vector retrieval: adds learned knowledge
- Self-learning → LLM manager: forms learned answer