Levanter

Levanter is an open-source WhatsApp bot created by lyfe00011, designed for messaging automation, group management, media tools, custom plugins and multi-session support. It also includes an optional API mode for developers who want to connect WhatsApp messaging with their own applications.

Two things set Levanter apart. It can run several WhatsApp accounts from a single instance, each with its own session, and its plugin system lets developers add new commands without changing the core bot. Its responses work in many languages, including English, Urdu, Hindi, Spanish, French, Bengali, Indonesian, Turkish, Russian, Arabic, Malayalam and Chinese, set with the BOT_LANG option.

With AHMED X, you deploy Levanter through a guided process instead of setting up the whole project on your own server. Generate a Session ID on Levanter’s official session page, enter it in the deployment form on AHMED X, configure the supported options, and follow the deployment status. AHMED X runs Levanter from its own maintained copy of the project, so the bot you deploy always comes from a source AHMED X controls.

Compare it with every other bot in the bot catalog, or read the full deployment guide before you start.

A Session ID is the credential that links the bot to your WhatsApp number, and Levanter’s official session page generates it. Make sure you are linking the intended WhatsApp account and that you understand which bot instance will use the resulting session.

Environment variables control how Levanter behaves without rewriting the bot’s source code. The project documents these variables in its configuration and deployment information. Availability and accepted values can depend on the current version and deployment interface, and the complete reference lives on the official environment variables page.

You do not need to customize every variable. Start with the required session credential and any fields marked as required, then change optional settings for your use case: a particular command prefix with PREFIX, supported responses in Urdu through the language options, or the API settings if you are a developer using the optional API. Never paste API keys or session credentials into public documentation.

One of Levanter’s most important features is its plugin-based architecture. Plugins introduce commands and additional behavior, so the bot adapts to different use cases without every feature being part of the core command set. The examples below are plugin use cases, not a guarantee that every plugin is present in the default installation.

You can also write your own. Levanter’s plugin-development guide documents a structure where a plugin defines a command pattern, a description, a category and an asynchronous handler. In the example, pattern defines the command pattern, desc the description shown for the command, type its category, and onlyGroup whether it is restricted to group chats. The handler receives the message, the text captured by the pattern, and the session context. Review any custom plugin before installing it: a plugin can access messages and act with the bot’s permissions, so only use code from trusted sources.

Beyond chat commands, Levanter’s repository documents an optional API mode for applications that need programmatic access to WhatsApp messaging. API mode is optional and is not enabled automatically on every deployment: it needs suitable configuration, and requests are authenticated with your API key in the x-api-key header. Read the GitHub README for endpoint definitions, request examples and current limitations.

Users who prefer self-hosting can follow the project’s official deployment guide at levanter.site/deploy. The GitHub README documents a manual Ubuntu setup using Node.js 20.x, Git, FFmpeg, Yarn and PM2. The repository’s documented commands and requirements may change, so follow the latest instructions instead of copied commands from an older version. For a guided workflow, the AHMED X Levanter page is the recommended starting point.

Levanter is an open-source project, which allows developers to inspect its source code. Open-source availability alone does not guarantee that every plugin, deployment or hosted instance is secure. A bot connected to a WhatsApp account may process personal messages and group activity, so use it responsibly and only install code you trust.