How nivedhitha0705/multi-agent-ai-system works
The repository contains three separate user-facing products. The main workflow is a terminal user submitting a request to the multi-agent orchestrator, which selects research/content, software-development, or planning work; specialist agents use a shared Gemini runner, and research also searches the web. Separately, a Flask café site serves pages and a Tkinter calculator evaluates button-entered expressions. Agent and café relationships are supported by excerpts; the calculator is represented only at the sampled-file level.
Main entry points: orchestrator.py Task Router · base_agent.py Gemini Runner · research.py Research Agent · app.py Flask Routes
Components 22
Agent Workflows
- CLI Loop
main.py - Task Router
agents/orchestrator.py - Research Agent
agents/research.py - Writer Agent
agents/writer.py - Coding Agent
agents/coder.py - Review Agent
agents/reviewer.py - Testing Agent
agents/tester.py - Task Manager
agents/task_manager.py
Agent Runtime
- Gemini Runner
agents/base_agent.py - Web Search
tools/search.py
Café Website
- Flask Routes
cafe-website/app.py - Page Templates
cafe-website/templates - Home Page
cafe-website/templates/index.html - Menu Page
cafe-website/templates/menu.html - Shared Layout
cafe-website/templates/base.html - Site Styles
cafe-website/static/style.css
Calculator
- Calculator UI
calculator.py
Other components
- Terminal User
- Gemini API
- Search Provider
- Café Visitor
- Calculator User
Connections 23
- Terminal User → CLI Loop: enters requests
main.py - CLI Loop → Task Router: routes input
main.py - Task Router → Research Agent: dispatches research
agents/orchestrator.py - Task Router → Writer Agent: dispatches writing
agents/orchestrator.py - Task Router → Coding Agent: dispatches coding
agents/orchestrator.py - Task Router → Review Agent: dispatches review
agents/orchestrator.py - Task Router → Testing Agent: dispatches testing
agents/orchestrator.py - Task Router → Task Manager: dispatches planning
agents/orchestrator.py - Research Agent → Web Search: searches topic
agents/research.py - Research Agent → Gemini Runner: synthesizes results
agents/research.py - Writer Agent → Gemini Runner: generates content
agents/writer.py - Coding Agent → Gemini Runner: generates code
agents/coder.py - Review Agent → Gemini Runner: reviews code
agents/reviewer.py - Testing Agent → Gemini Runner: writes tests
agents/tester.py - Task Manager → Gemini Runner: plans tasks
agents/task_manager.py - Gemini Runner → Gemini API: requests generation
agents/base_agent.py - Web Search → Search Provider: queries web
tools/search.py - Café Visitor → Flask Routes: requests pages
- Flask Routes → Home Page: renders home
cafe-website/app.py - Flask Routes → Menu Page: renders menu
cafe-website/app.py - Page Templates → Shared Layout: provides layout
- Shared Layout → Site Styles: loads stylesheet
- Calculator User → Calculator UI: clicks buttons
calculator.py