Zero Ichi

The WhatsApp bot that does it all (so you don't have to).
Built with Neonize.

📚 Read the Docs

---

Why Zero Ichi?

Because life is too short for boring bots.

• Agentic AI: A smart assistant that remembers context, executes commands, and might just be your new best friend.
• Universal Downloader: Grab videos from YouTube, TikTok, Instagram, and 1000+ other sites. Yes, even that one.
• The Ban Hammer: Keep your groups clean with anti-link, anti-delete, warnings, and blacklists.
• Time Travel: Okay, not really, but our Scheduler lets you send messages in the future (cron supported!).
• Polyglot: Speaks English and Indonesian fluently. Add your own language if you're feeling adventurous.
• Shiny Dashboard: A web interface to manage everything because terminals are scary sometimes.

See everything it can do →

---

Get Started

1. Install via pip & git

pip install uv
git clone https://github.com/MhankBarBar/zero-ichi
cd zero-ichi
uv sync  # magic happens here

2. Configure

Copy the example config and make it yours:

{
  "$schema": "./config.schema.json",
  "bot": {
    "name": "my_super_bot",
    "prefix": "/",
    "login_method": "qr"
  }
}

(Check the Config Guide for the nerdy details)

3. Launch

uv run main.py

Scan the QR code and you're in business.

---

Documentation

Everything you need to know, neatly organized:

👉 zeroichi.mhankbarbar.dev

• Commands List
• How to Configure
• The AI Stuff
• Downloading Media

---

Project Structure

• commands/: Where the magic happens
• core/: The brain
• dashboard/: The pretty face
• locales/: The dictionary

Contributing Guide →

---

License

MIT