How rayanfer32/atlas-md works
Atlas MD is a feature-rich WhatsApp bot: users send commands or messages through WhatsApp, the bot dispatches them to command plugins, and replies are sent back through its Baileys connection. The product also exposes pairing/status and webhook APIs, persists bot settings and authentication state in MongoDB, and supports hot-installed plugins. The README documents AI chat, downloads, moderation, group management, stickers/conversion, search and character features; these are mapped to plugin and system paths from the tree. Several runtime details are unsampled, so uncertain internal wiring is omitted.
Main entry points: ReadCommands.ts Command loader · connection.ts Bot connection · MongoDb_Core.ts Bot settings · core.ts AI and chat
Components 21
Bot runtime
- Application entry
index.ts - Bot connection
core/connection.ts - Message events
core/events.ts - Command loader
System/ReadCommands.ts - Plugin manager
core/pluginManager.ts
Command features
- Moderation
Plugins/moderator.ts - Group management
Plugins/group.ts - AI and chat
Plugins/core.ts - Media downloads
Plugins/downloader.ts - Search and media
Plugins/search.ts - Stickers and conversion
Plugins/tools.ts - Bot characters
System/BotCharacters.js
Persistence
- Bot settings
System/MongoDB/MongoDb_Core.ts - MongoDB models
System/MongoDB/MongoDB_Schema.ts - Session auth
System/MongoAuth/MongoAuth.ts - Session records
System/MongoAuth/Schema/SessionSchema.ts
External interfaces
- HTTP and pairing API
core/server.ts
External services
- AI providers
- Media and search providers
Other components
- WhatsApp user
Connections 26
- WhatsApp user → WhatsApp: sends messages
- WhatsApp → Bot connection: delivers events
- Application entry → Bot connection: starts
- Bot connection → Session auth: loads credentials
- Session auth → Session records: reads and writes
- Bot connection → Message events: dispatches events
- Message events → Command loader: dispatches commands
- Command loader → Moderation: routes commands
- Command loader → Group management: routes commands
- Command loader → AI and chat: routes commands
- Command loader → Media downloads: routes commands
- Command loader → Search and media: routes commands
- Command loader → Stickers and conversion: routes commands
- Command loader → Bot characters: routes commands
- Moderation → Bot settings: reads and updates
- Group management → Bot settings: reads and updates
- AI and chat → Bot settings: reads settings
- Bot settings → MongoDB models: queries
- Application entry → HTTP and pairing API: starts server
- HTTP and pairing API → Bot connection: uses socket
- Bot connection → WhatsApp: sends replies
- Plugin manager → Bot settings: loads plugin URLs
- Plugin manager → Command loader: reloads commands
- AI and chat → AI providers: requests responses
- Media downloads → Media and search providers: fetches media
- Search and media → Media and search providers: searches providers