Problem
Running your own commands, group rules, or scheduled messages in WhatsApp usually means relying on a service someone else hosts.
Self-hosted WhatsApp bot
Levix — by Leviro
Free, open-source personal WhatsApp bot with 69 commands, group moderation, and an optional AI agent.
LiveProduct languages: English · ArabicLicense: MIT
69
commands
levix
WhatsAppA clearer path through the work
Outcome
A self-hosted personal bot running on your own machine or server with 69 configurable commands, automated group moderation, and scheduled messaging.
Features
69 configurable commands
Includes utilities, notes, reminders, polls, media, speech, translation, weather, and prayer times, managed from a web control panel without restarting.
Group moderation
Anti-link, media control, forbidden words, and anti-spam feed one warning counter per member. Each group sets its own policy, warning limit, and action at the limit — remove the member or flag them for admin review.
Optional AI agent
Search the web, read pages, and remember context using your own Google Gemini, OpenAI-compatible, or Anthropic API key. Replies follow the language and dialect of each message.
Message translation
Translate text or a replied message with an AI engine or Google. Arabic becomes English and anything else becomes Arabic unless you name a language, with options for a summary, formal or casual tone, idiom notes, and language detection.
Persistent message scheduling
Schedule one-off, daily, and weekly messages that survive restarts, complete with delivery status and manual retry.
Media and speech utilities
Text-to-speech, voice note transcription (Gemini, or an OpenAI-compatible Whisper endpoint), QR code generation, and URL shortening.
Flexible deployment options
Runs via npm (Node.js 24+), Docker, systemd installer, standalone binaries, headless mode, or an Android APK (ARM64 or ARMv7, Android 10+).
How it works
- 01
Deploy
Run Levix on your computer, VPS, Docker container, or Android device.
- 02
Pair with WhatsApp
Link your WhatsApp account using the panel QR code or an 8-character pairing code.
- 03
Manage commands
Enable, rename, and set permissions for commands directly from the web control panel.
FAQ
Is Levix open source and free?
Yes. Levix is free software published under the MIT license, with full source code available on GitHub.
Do I need an API key to use Levix?
Only for AI features. Chat can use your own Google Gemini, OpenAI-compatible, or Anthropic key. Image generation always uses Gemini. Voice notes are transcribed with Gemini or an OpenAI-compatible Whisper endpoint. Translation works without a key through Google's free endpoint, or through the official Cloud Translation API when you add a Google Translate API key. The rest of Levix works without an AI key.
Can I translate messages inside WhatsApp?
Yes. The translate command works on text or a replied message, using an AI engine or Google. Arabic is translated to English and anything else to Arabic unless you name a language. You can ask for a summary, a formal or casual tone, notes on idioms, or language detection.
How does group moderation handle repeated violations?
Anti-link, media control, forbidden words, and anti-spam all feed one shared warning counter per member. Each group sets a Relaxed, Standard, or Strict policy, a warning limit, and the action at the limit — remove the member automatically or flag them for admin review. Flagged members appear in the panel and in the group for admins to kick, clear, or dismiss.
What if I forget the control-panel password?
You can reset it with a code sent over WhatsApp. If you added and verified a recovery email in Settings, that address can also receive a one-time reset code. The Levix mail relay stores only keyed hashes and authorization state, never the readable address, code or token.
How do I install and run Levix?
You can run Levix via npm with Node.js 24+, Docker, a Linux systemd installer, standalone binaries, headless mode, or on an Android phone (ARM64 or ARMv7, Android 10+) using the APK.
Does Levix support Arabic?
The web control panel and the Android app are in Arabic and English. Bot replies follow the language of each message, and can be pinned to Arabic or English. The documentation site is in English.
