How fullstacksjs/alita-bot works
Alita is a Telegram group-management bot. Telegram updates enter through polling or the optional webhook, are dispatched to command and moderation modules, and produce moderation actions or group features such as filters, notes, greetings, warnings, and raid protection. Modules use shared permission, extraction, formatting, and media utilities and persist configuration and activity through SQLite repositories. The README establishes the major capabilities; sampled source confirms startup, dispatch setup, HTTP handling, and selected repository behavior, but not every module’s internal calls.
Main entry points: registry.go Module dispatcher · db.go SQLite database · main.go Process startup · server.go Webhook and health
Components 33
Bot runtime
- Process startup
main.go - Bot initialization
alita/main.go - Update delivery
main.go - Webhook and health
alita/utils/httpserver/server.go - Module dispatcher
alita/modules/registry.go
Group features
- Moderation
alita/modules/moderation.go - Bans and mutes
alita/modules/bans.go - Flood protection
alita/modules/antiflood.go - Raid protection
alita/modules/antiraid.go - Message filters
alita/modules/filters.go - Notes
alita/modules/notes.go - Greetings
alita/modules/greetings.go - Warnings
alita/modules/warns.go - Approvals
alita/modules/approvals.go - Backup and restore
alita/modules/backup.go - Chat connections
alita/modules/connections.go
Shared services
- Permission checks
alita/utils/chat_status/chat_status.go - Command pipeline
alita/utils/helpers/command_pipeline.go - Message extraction
alita/utils/extraction/extraction.go - Content handling
alita/utils/content/content.go - Media sending
alita/utils/media/sender.go - Localization
alita/i18n/manager.go - Configuration
alita/config/config.go
Persistence
- SQLite database
alita/db/db.go - Chat settings
alita/db/chats/repository.go - Protection data
alita/db/antiraid/repository.go - Filter records
alita/db/filters/repository.go - Note records
alita/db/notes/repository.go - Greeting records
alita/db/greetings/repository.go - Warning records
alita/db/warns/repository.go - Backup storage
alita/db/backup/backup.go
Other components
- Telegram users
- Telegram API
Connections 40
- Telegram users → Telegram API: sends updates
README.md - Process startup → Bot initialization: initializes bot
main.go - Process startup → Update delivery: starts delivery
main.go - Process startup → Webhook and health: configures server
main.go - Telegram API → Update delivery: delivers updates
main.go - Update delivery → Module dispatcher: dispatches updates
- Webhook and health → Module dispatcher: routes updates
alita/utils/httpserver/server.go - Bot initialization → Module dispatcher: loads modules
alita/main.go - Module dispatcher → Moderation: registers feature
- Module dispatcher → Bans and mutes: registers feature
- Module dispatcher → Flood protection: registers feature
- Module dispatcher → Raid protection: registers feature
- Module dispatcher → Message filters: registers feature
- Module dispatcher → Notes: registers feature
- Module dispatcher → Greetings: registers feature
- Module dispatcher → Warnings: registers feature
- Module dispatcher → Approvals: registers feature
- Module dispatcher → Backup and restore: registers feature
- Module dispatcher → Chat connections: registers feature
- Command pipeline → Permission checks: checks access
alita/utils/helpers/command_pipeline.go - Raid protection → Protection data: reads and writes
alita/modules/antiraid.go - Message filters → Filter records: uses records
- Notes → Note records: uses records
- Greetings → Greeting records: uses records
- Warnings → Warning records: uses records
- Backup and restore → Backup storage: uses storage
alita/modules/backup.go - Protection data → SQLite database: queries SQLite
alita/db/antiraid/repository.go - Filter records → SQLite database: queries SQLite
alita/db/filters/repository.go - Note records → SQLite database: queries SQLite
alita/db/notes/repository.go - Greeting records → SQLite database: queries SQLite
alita/db/greetings/repository.go - Warning records → SQLite database: queries SQLite
alita/db/warns/repository.go - Chat settings → SQLite database: queries SQLite
alita/db/chats/repository.go - Content handling → Localization: uses translations
alita/utils/content/content.go - Message extraction → Permission checks: checks access
alita/utils/extraction/extraction.go - Media sending → Content handling: formats content
alita/utils/media/sender.go - Process startup → Configuration: loads settings
main.go - Process startup → Localization: initializes locales
main.go - Webhook and health → SQLite database: checks health
alita/utils/httpserver/server.go - Moderation → Telegram API: moderates members
- Bans and mutes → Telegram API: restricts members