How prashanthpathi/dota-2-ai-assistant works
RealmMaster is an ADK-based tabletop RPG companion. A player or GM sends chat through the web proxy to the agent, which can answer with game tools and render rich A2UI responses. The repository also exposes A2A and reasoning-engine serving surfaces and shares session, artifact, and memory services across runtime paths. The README documents the game-tool integrations; sampled excerpts show server wiring and selected tool implementations, so undocumented internal tool-call details are not inferred.
Main entry points: agent.py ADK Agent · fast_api_app.py FastAPI Server · index.html Chat UI · services.py Shared Services
Components 23
Chat Interface
- Chat Proxy
frontend/main.py - Chat UI
frontend/static/index.html
Agent Runtime
- FastAPI Server
app/fast_api_app.py - A2A Routes
app/app_utils/a2a.py - Reasoning Adapter
app/app_utils/reasoning_engine_adapter.py - ADK Agent
app/agent.py - Shared Services
app/app_utils/services.py - A2UI Formatter
app/a2ui_utils.py
Game Tools
- Dice Roller
app/agent.py - Item Catalog
app/agent.py - Inventory Manager
app/agent.py - Bestiary Lookup
app/agent.py - Venue Finder
app/agent.py - Item Artwork
app/agent.py - Code Sandbox
app/agent.py
Cloud and External Services
- Firestore
- Memory Bank
- Artifact Storage
- Vertex AI
- Google Maps APIs
- 5e SRD API
Other components
- Player or GM
- Web Browser
Connections 30
- Player or GM → Chat UI: sends chat
README.md - Chat UI → Chat Proxy: posts chat
README.md - Chat Proxy → A2A Routes: forwards A2A
frontend/main.py - A2A Routes → ADK Agent: dispatches requests
app/fast_api_app.py - FastAPI Server → A2A Routes: registers routes
app/fast_api_app.py - FastAPI Server → Reasoning Adapter: registers routes
app/fast_api_app.py - Reasoning Adapter → ADK Agent: dispatches methods
app/app_utils/reasoning_engine_adapter.py - FastAPI Server → ADK Agent: builds runner
app/fast_api_app.py - FastAPI Server → Shared Services: gets shared services
app/fast_api_app.py - Reasoning Adapter → Shared Services: gets services
app/app_utils/reasoning_engine_adapter.py - ADK Agent → Dice Roller: provides tool
README.md - ADK Agent → Item Catalog: provides tools
README.md - ADK Agent → Inventory Manager: provides tool
README.md - ADK Agent → Bestiary Lookup: provides tool
README.md - ADK Agent → Venue Finder: provides tools
README.md - ADK Agent → Item Artwork: provides tool
README.md - ADK Agent → Code Sandbox: uses executor
README.md - Item Catalog → Firestore: reads and writes
README.md - Inventory Manager → Firestore: updates inventory
README.md - Bestiary Lookup → 5e SRD API: fetches stats
README.md - Venue Finder → Google Maps APIs: queries places
README.md - Item Artwork → Vertex AI: generates image
README.md - Item Artwork → Artifact Storage: saves artifact
README.md - Code Sandbox → Vertex AI: executes sandbox
README.md - ADK Agent → Memory Bank: preloads memories
README.md - Shared Services → Memory Bank: provides memory service
app/app_utils/services.py - Shared Services → Artifact Storage: provides artifact service
app/app_utils/services.py - ADK Agent → A2UI Formatter: formats responses
README.md - Chat Proxy → Chat UI: returns chat parts
frontend/main.py - Chat UI → Web Browser: renders cards
README.md