How hamidnawaz583/disaster-chatbot works
Disaster is a voice-driven desktop assistant: a user speaks after a wake word, the application captures and transcribes a command, the agent reasons through tool calls, and the interface or voice layer presents the outcome. Its tools cover app launching, browser control, desktop input, screen capture/OCR, system information, and terminal commands. The excerpts show the agent’s registry-based execution and several tool registrations; connections among unsampled tool implementations and the registry are therefore shown only where registration is evidenced. The README is empty.
Main entry points: tool_registry.py Tool registry · loop.py Agent loop · voice_agent.py Voice agent · app.py Desktop UI
Components 17
Voice interaction
- Desktop UI
ui/app.py - Wake detection
voice/wakeword.py - Speech listener
voice/listener.py - Speech output
voice/speaker.py - Voice agent
voice/voice_agent.py
Agent reasoning
- Agent loop
agent/loop.py - Model reasoning
agent/brain.py - Tool router
agent/router.py
Desktop tools
- App launcher
tools/apps/launcher.py - Browser control
tools/browser/browser.py - Desktop input
tools/desktop/desktop.py - Screen and OCR
tools/screen/screen.py - System information
tools/system.py - System command
tools/system/command.py - Safe terminal
tools/terminal/terminal.py
Tool infrastructure
- Tool registry
core/tool_registry.py
Other components
- User
Connections 24
- User → Desktop UI: speaks to
- Desktop UI → Wake detection: detects wake
ui/app.py - Desktop UI → Speech listener: captures speech
ui/app.py - Desktop UI → Agent loop: submits command
ui/app.py - Agent loop → Speech output: speaks result
- Voice agent → Wake detection: detects wake
voice/voice_agent.py - Voice agent → Speech listener: captures speech
voice/voice_agent.py - Voice agent → Agent loop: submits command
voice/voice_agent.py - Voice agent → Speech output: speaks response
voice/voice_agent.py - Agent loop → Model reasoning: requests reasoning
agent/loop.py - Agent loop → Tool registry: executes tools
agent/loop.py - Tool router → App launcher: opens app
agent/router.py - Tool router → Browser control: opens site
agent/router.py - Tool router → System command: runs command
agent/router.py - App launcher → Tool registry: registers tools
tools/apps/launcher.py - Browser control → Tool registry: registers tools
tools/browser/browser.py - Desktop input → Tool registry: registers tools
tools/desktop/desktop.py - Screen and OCR → Tool registry: registers tools
tools/screen/screen.py - System information → Tool registry: registers tools
tools/system.py - Safe terminal → Tool registry: registers tools
tools/terminal/terminal.py - Tool registry → Desktop input: dispatches tools
tools/desktop/desktop.py - Tool registry → Screen and OCR: dispatches tools
tools/screen/screen.py - Tool registry → System information: dispatches tools
tools/system.py - Tool registry → Safe terminal: dispatches tools
tools/terminal/terminal.py