Skip to content
Open sourceSelf-hostedMIT

Your personal
WhatsApp bot.

AI, commands and useful everyday tools inside WhatsApp — self-hosted on your own machine or server.

55 commands · AI agent · runs where you want

WhatsApp connected

Levix

online

Two commands. That's the setup.

npm install -g levix
levix

Needs Node.js 24 or newer. All install methods

Prefer Docker or a standalone executable? See every way to run Levix

The command system

One chat.
A lot you can do.

55 commands across AI, personal tools, groups, media and scheduling — every one of them renameable, re-permissionable or switchable off from the panel.

An agent, not a chat box

Levix

online

!gemini <text>

AI

An agent,
not a chat box.

!gemini can search the web, open a page and read it, save things to its long-term memory and hand out bot roles — across several tool rounds, narrating the whole run inside a single message it keeps editing.

  • Google Gemini under the hood, with an optional Groq fallback
  • Long-term memory in plain Markdown you can edit by hand
  • A personality file you rewrite from the panel — no restart

Levix

online

!gemini what's actually new in Node 24?
Levix
Searching the web…

Personal tools

A toolbox that lives
where your thumb lives.

To-dos, private debts, saved notes — the small things you'd otherwise scatter across five apps, folded into one conversation with yourself.

It's your bot: the todo list is yours, the debts are yours, and the chat is the one you already open fifty times a day.

!todo add Call the bank
✓ Added to your todos

The list you'll actually check — it lives in the chat you already have open.

!debt
📒 Sara owes you 200 · you owe Omar 50

Private debt tracking, kept between you and the bot.

!notes
3 saved notes — wifi, gym, books

Notes with keywords you set once and recall forever.

F

Friday Friends

8 members · 3 admins · Levix is admin

moderated

Groups

Keeps the peace
while you're away.

Welcome messages for new members, anti-link and anti-spam that enforce themselves, media rules, warnings with auto-kick — plus the usual !group kick, promote, demote and tagadmins when you want to do it yourself.

Welcome messages
set per group, with variables
Anti-link + anti-spam
rules that run without you
Warnings
auto-kick at the limit you choose
Rules & notes
!rules anyone can recall

Scheduling

Send it now.
Or send it at 9.

One-off messages with !schedule, recurring ones with !autoschedule. Stored in the database, listed in the panel — not in a cron file you'll forget exists.

!schedule "09:00 01-09-2026" "Pay the server bill"
!autoschedule daily 09:00 Standup in 10 minutes

Tomorrow

  1. 07:30

    — nothing scheduled —

  2. 09:00

    Pay the server bill

    Levix · scheduled💡 Pay the server bill
  3. 21:00

    — nothing scheduled —

!tts The deploy is green. Go home.
0:04
!stt

Reply to any voice note and get the text back — transcribed by Gemini, free.

“Meeting moved to 5, bring the report”

!qr

A QR code from any text or link

!shortlink

Long URL in, is.gd link out

Media

Voice, QR codes
and tidy links.

Turn text into a voice note and back again, stamp out a QR code, shrink a monster URL — the small media chores, handled inside the conversation.

Transcription runs on the same Gemini key as the AI agent — no extra service, no extra cost line.

Web panel

Configure Levix
from your browser.

There is no config file to edit and no key to generate — the database is the source of truth, and the panel is how you edit it. Change the prefix, permissions, API keys or tuning while the bot runs: it applies to the very next message.

localhost:3001

Commands

Rename, re-permission, or switch off — live

55 loaded
CommandOn
!gemini
!todo
!weather
!poll

Saved — applies to the next message, no restart needed.

1Start Levix
2Open the browser
3Configure
4Pair

Headless

No web UI.
No open port.
Just Levix.

On a server you may not want a panel at all. levix headless runs the bot and nothing else — no Express, no socket.io, no listener. An unpaired install prints its QR straight to the terminal.

levix headless

You can switch modes freely — the data directory is the same either way.

terminal

How it works

Up and running in minutes.

No config file, no keys to generate, no database server. A password in the browser and one QR code — that's the entire ceremony.

  1. Install

    One npm command — or the VPS installer, Docker, or a standalone executable.

    $ npm install -g levix
  2. Start Levix

    Run levix. On a desktop the panel opens in your browser by itself.

    $ levix● running
  3. Pair WhatsApp

    Scan one QR from WhatsApp → Settings → Linked devices. Like WhatsApp Web.

  4. Done

    Send !ping anywhere. The bot answers. That's the whole setup.

    !ping → Pong! 🏓

Self-hosted

Your bot.
Your data.

Levix runs on the machine you put it on — your laptop, a mini PC under the TV, or a VPS. The runtime state lives next to it: SQLite through Node's own node:sqlite module, so the whole datastore is one file with zero dependencies. No database server, nothing to compile.

  • Everything mutable lives in one directory — database, WhatsApp session, memory files, logs.
  • levix where prints it; copying it is a full backup — the WhatsApp session included, so moving machines means no rescan.
  • You own the deployment: you start it, you update it, you stop it.

WhatsApp

your account, linked like WhatsApp Web

Levix

the bot, self-hosted

SQLite

node:sqlite
Installed with npm~/.levix
Running from a git clone./data
Dockerlevix-data volume

Distribution

Same Levix.
Your environment.

One codebase, five ways to run it. The data directory follows you between them.

  1. Your desktop

    npm

    npm install -g levix — the panel opens in your browser, data lands in ~/.levix. A laptop that's usually on is enough.

  2. A Linux VPS

    install.sh

    The installer sets up a hardened systemd service that starts on boot and survives restarts — it comes back without you.

  3. Docker

    compose

    git clone, docker compose up -d. Nothing on your system but the container; everything the bot owns lives in one volume.

  4. Terminal only

    headless

    levix headless — no panel, no port, no listener. The QR prints straight into the terminal on first run.

  5. Standalone executable

    binary

    A single file that carries its own Node, its own SQLite and all 55 commands. Copy it to a machine with nothing installed and run it.

Open source · MIT

Open source.
Built in the open.

The whole bot — every command, the panel, the packaging — is public. Read it before you run it; that's the point.

RepositoryAbdodiab2005/levix
License
MIT
Commands
55
Runtime
Node 24+
Author
Leviro
Levix

Make WhatsApp yours.

Install Levix and turn your WhatsApp into a personal toolbox.

npm install -g levix · MIT · self-hosted