How mauricebarksdale/roundtable works
Roundtable is a multi-agent chat application. Users authenticate, configure sessions and participating agents, send messages, and receive orchestrated model responses; the interface also supports streamed conversations, search, file tools, and image generation. The backend exposes API routes, coordinates agent/model execution, and persists conversation state through Supabase. The graph preserves documented and indexed product areas, but several implementation details—especially frontend-to-API calls and some orchestration stages—were not excerpted, so uncertain links are omitted or marked unverified.
Main entry points: main.py FastAPI application · supabase.py Supabase client · runner.py Agent orchestrator · client.py Model client
Components 28
Web application
- Chat interface
frontend/app/components/conversation-view.tsx - Frontend API client
frontend/lib/api-client.ts - Stream client
frontend/lib/sse-client.ts - Client state
frontend/lib/store.ts
API and identity
- FastAPI application
backend/main.py - Authentication
backend/auth/dependencies.py - Session routes
backend/routers/sessions.py - Agent routes
backend/routers/agents.py - Message routes
backend/routers/messages.py - Streaming routes
backend/routers/streaming.py
Conversation runtime
- Agent orchestrator
backend/orchestrator/runner.py - Agent context
backend/orchestrator/context.py - Tool executor
backend/orchestrator/tool_executor.py
Chat capabilities
- Image routes
backend/routers/images.py - Search routes
backend/routers/search.py - Tool routes
backend/routers/tools.py - Tool registry
backend/tool/registry.py - File tools
backend/tool - Web search tool
backend/tool/web_search.py - File processing
backend/processors/file_processor.py
Persistence and models
- Message history
backend/chat_messages.py - Supabase client
backend/storage/supabase.py - Model client
backend/model_client/client.py - Provider catalog
backend/schemas/providers.py - Runtime settings
backend/settings.py
Other components
- User
- Model providers
- Supabase service
Connections 35
- User → Chat interface: uses
- Chat interface → Frontend API client: requests
- Stream client → Frontend API client: uses
frontend/lib/sse-client.ts - FastAPI application → Authentication: installs
backend/main.py - FastAPI application → Session routes: registers
backend/main.py - FastAPI application → Agent routes: registers
backend/main.py - FastAPI application → Message routes: registers
backend/main.py - FastAPI application → Streaming routes: registers
backend/main.py - FastAPI application → Image routes: registers
backend/main.py - FastAPI application → Search routes: registers
backend/main.py - FastAPI application → Tool routes: registers
backend/main.py - FastAPI application → Provider catalog: configures
backend/main.py - FastAPI application → Supabase client: initializes
backend/main.py - Authentication → Supabase client: verifies ownership
backend/auth/dependencies.py - Session routes → Message history: fetches history
backend/routers/sessions.py - Session routes → Supabase client: reads and writes
backend/routers/sessions.py - Message routes → Message history: uses history
backend/routers/messages.py - Message routes → Agent orchestrator: starts turns
- Streaming routes → Agent orchestrator: streams runs
- Agent routes → Supabase client: reads and writes
backend/routers/agents.py - Image routes → Model client: requests generation
backend/routers/images.py - Image routes → Supabase client: stores image data
backend/routers/images.py - Search routes → Supabase client: searches
backend/routers/search.py - Agent orchestrator → Agent context: loads context
backend/orchestrator/runner.py - Agent orchestrator → Model client: requests completions
backend/orchestrator/runner.py - Agent orchestrator → Tool executor: dispatches tools
backend/orchestrator/runner.py - Tool executor → Tool registry: resolves tools
backend/orchestrator/tool_executor.py - Tool registry → File tools: registers
- Tool registry → Web search tool: registers
- File tools → File processing: processes files
- Message history → Supabase client: reads and writes
backend/chat_messages.py - Model client → Provider catalog: uses definitions
backend/model_client/client.py - Model client → Model providers: calls
- Supabase client → Supabase service: authenticates and queries
backend/storage/supabase.py - FastAPI application → Runtime settings: configures
backend/main.py