sonic-bot
Sonic is a self-hosted WhatsApp bot for community management and member engagement, featuring economy systems, mini-games, modular commands, and group tools.
Ficha actualizada 22 sept 2026, 20:24 · upstream 22 sept 2026, 20:05 · release sin release detectada
Qué es sonic-bot
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Sonic is a self-hosted WhatsApp bot designed to enhance community interaction through integrated features. It combines administrative tools with an economy system that allows members to earn points, work tasks, and receive rewards. The platform supports mini-games such as coin flips, dice rolling, roulette, slots, and blackjack for instant entertainment. Sonic also provides utility commands like weather checks, image processing, and wiki lookups, along with a downloader for playing YouTube songs.
The bot features a modular architecture that makes it easy to extend new functionality without rewriting the entire codebase. It includes permission-based access control where only designated owners can modify settings or manage participants. The economy system tracks balances, work points, daily rewards, and inventory items such as stickers and wallpapers. Members can participate in leaderboards based on their earnings.
Sonic supports multiple operating modes including public, private, self-restricted, admin-only groups, and admin-all-groups configurations. It uses SQLite for persistent storage of user data, economy balances, and configuration settings. The bot is optimized for speed with a modular design that allows individual command modules to be developed independently.
- Admins can manage group members by promoting, demoting, kicking, or inviting new participants
- Members earn points through completing tasks, playing mini-games, and participating in leaderboards
- The economy system allows users to deposit funds, withdraw earnings, buy items like stickers or wallpapers
- Mini-games such as coin flips, roulette, and blackjack provide entertainment for group members
- Utility commands enable quick access to weather information, image generation, and wiki lookups
- The bot supports offline operation with auto-save configuration that persists across restarts
- Sonic is fully self-hosted with no external dependencies or API calls required
- The modular command architecture allows new features to be added without modifying the core codebase
- Economy system supports multiple currencies, work tasks, and a leaderboard ranking mechanism
- Permission-based access control ensures only authorized users can modify group settings
- Auto-save configuration means settings persist across bot restarts without manual intervention
- The bot includes offline operation with SQLite persistence for user data and economy balances
- Sonic does not support WhatsApp Business API or official WhatsApp business features
- Economy system requires a minimum balance to participate in certain activities like fishing or hunting
- Mini-games may be restricted by group settings or require specific permissions to access
- The bot is not designed for high-volume messaging and may experience latency during peak usage
- No built-in moderation tools exist, requiring manual intervention for spam detection
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
To deploy Sonic, install Node.js (v18+), npm, and Git. Clone the repository and run `npm install`. Create a `.env` file with your WhatsApp number as `OWNER_NUMBER`, set `NODE_ENV=production`, and configure FFMPEG paths if needed. Run `npm start` to initialize the bot. Connect via WhatsApp by entering your phone number; Sonic will prompt for the pairing code shown in terminal output. The bot stores data in SQLite at `./data/sonic.db`. For production use, consider running on a VPS with sufficient resources (at least 4 CPU cores and 2GB RAM). Use Docker Compose or systemd services to manage multiple instances if needed.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.