One question. Two agents. One combined answer.
Three Teams · Four Meetings · Docker on Akash
Gemini splits a complex question into independent research and developer tasks. Both agents run concurrently, report live tool activity to the dashboard, and return structured findings for Gemini to synthesize into an answer with sources.
flowchart LR
Q[User Question] --> P[Gemini Planner]
P --> R[Research Agent]
P --> D[Developer Agent]
R --> S[Gemini Synthesis]
D --> S
S --> A[Answer + Sources]
Focus: AI tool pipelines, concurrent coordination, Docker deployment, and a polished dashboard. React + Tailwind power the interface; FastAPI coordinates the services. Akash is the target deployment environment.
Starter status: The end-to-end mock workflow works without API keys. The shared framework is implemented; real research and developer tools remain team assignments.
| Team | Owns | Start here |
|---|---|---|
| A · Research | Search, papers, Wikipedia, PDFs, notes, weather | Research guide |
| B · Developer | GitHub, browsing, Python/C++, DuckDB, repo analysis | Developer guide |
| C · Full Stack | Planning, orchestration, synthesis, dashboard, deployment | Backend & integration · Dashboard |
Each agent starts with app.py and tools.py. All teams use the same contracts, Gemini helper, and tool-event protocol. Keep API keys in each service's ignored .env file.
Develop on team-prefixed branches and review small pull requests. Merge and connect the team implementations during Meeting 3; coordinate shared-interface changes with affected teams.
For Meeting 3 integration, run from the repository root with Docker running:
python3 scripts/setup_env.py
docker compose up --buildSee the dashboard guide and backend guide for service instructions. For local development and verification, see the shared starter guide.
Integration starts in Meeting 3. Meetings 1–2 focus on independent team development against agreed interfaces and local fixtures; Meeting 4 is the final presentation.
| Meeting | Team A · Research | Team B · Developer | Team C · Full Stack |
|---|---|---|---|
| 01 · Foundations | Set up keys and shared helpers; start Brave, Wikipedia, and local tool-event checks. | Set up keys and shared helpers; start GitHub API and local tool-event checks. | Agree contracts; develop FastAPI and dashboard skeletons independently with fixtures. |
| 02 · Development | Complete research tools and validate structured results independently. | Complete developer tools and validate structured results independently. | Build and test planning, orchestration, synthesis, and dashboard components with local fixtures. |
| 03 · Integration | Dockerize and connect the real research pipeline; verify events and sources. | Dockerize and connect the real developer pipeline; verify events and artifacts. | Integrate real outputs, polish the dashboard, deploy, and rehearse. |
| 04 · Final Demo | Present the research pipeline and tools. | Present the developer pipeline and tools. | Present the dashboard, architecture, and integrated application. |
Meeting 3 checkpoint: Connect both real agents, backend, and dashboard; verify concurrent execution, live tool events, combined results, and deployment on Akash.