How angle-brackets/rotibot works
Roti is a Discord bot whose slash-command and message workflows turn server or user requests into replies, generated content, playback, lookups, and usage metrics. The main entry point initializes shared state and storage; feature cogs handle distinct domains, with Supabase backing persistent features and external services powering AI, code execution, and music. The README documents capabilities beyond the sampled excerpts; those feature nodes are retained, but uncertain implementation-level connections are omitted.
Main entry points: data.py Persistent data · main.py Roti bot · RotiBrain.py Generation engine · talkback.py Talkbacks
Components 26
Bot runtime
- Roti bot
main.py
Discord features
- Talkbacks
cogs/talkbacks/talkback.py - AI generation
cogs/generate/generate.py - Music playback
cogs/music/music.py - Quotes
cogs/quotes/quote.py - Server settings
cogs/settings/settings.py - Personal statuses
cogs/motd/motd.py - Wikipedia lookup
cogs/wiki/wikipedia.py - Wizard101 wiki
cogs/wiz/wiz.py - Code execution
cogs/execute/execute.py - Help and changelog
cogs/help/help.py - Usage statistics
cogs/statistics/statistics.py
Shared services
- Runtime state
database/bot_state.py - Persistent data
database/data.py - Generation engine
cogs/generate/RotiBrain.py - Execution engine
cogs/execute/ExecutionEngine.py - Metrics and caching
cogs/statistics/statistics_helpers.py - Bot utilities
utils/RotiUtilities.py - Singleton helper
utils/Singleton.py
External services
- Supabase
- Pollinations API
- Lavalink
- Piston execution API
- WizWiki
- Wikipedia
Other components
- Discord users
Connections 26
- Discord users → Roti bot: sends commands
README.md - Roti bot → Runtime state: initializes
main.py - Roti bot → Persistent data: initializes
main.py - Roti bot → Bot utilities: configures logging
main.py - Talkbacks → Discord users: replies in chat
README.md - Talkbacks → Persistent data: reads and writes
cogs/talkbacks/talkback.py - Talkbacks → Generation engine: generates replies
cogs/talkbacks/talkback.py - AI generation → Generation engine: requests generation
cogs/generate/generate.py - Generation engine → Pollinations API: requests models
cogs/generate/RotiBrain.py - Music playback → Lavalink: controls playback
README.md - Music playback → Persistent data: uses settings
cogs/music/music.py - Quotes → Persistent data: reads and writes
cogs/quotes/quote.py - Server settings → Persistent data: reads and writes
cogs/settings/settings.py - Server settings → Generation engine: configures generation
cogs/settings/settings.py - Personal statuses → Persistent data: stores statuses
cogs/motd/motd.py - Wikipedia lookup → Wikipedia: searches articles
README.md - Wizard101 wiki → WizWiki: looks up wiki data
README.md - Code execution → Execution engine: runs submitted code
cogs/execute/execute.py - Execution engine → Piston execution API: executes code
cogs/execute/ExecutionEngine.py - Execution engine → Metrics and caching: records metrics
cogs/execute/ExecutionEngine.py - Usage statistics → Metrics and caching: gets metrics
cogs/statistics/statistics.py - Metrics and caching → Persistent data: queries usage
cogs/statistics/statistics_helpers.py - Help and changelog → Bot utilities: uses utilities
cogs/help/help.py - Persistent data → Supabase: persists records
database/data.py - Persistent data → Singleton helper: uses singleton
database/data.py - Runtime state → Singleton helper: uses singleton
database/bot_state.py