Zero Ichi

Appearance

Installation ​

One-Line Install ​

The fastest way to get started. This auto-installs all dependencies, clones the repo, and sets up your environment.

Linux / macOS:

bash
curl -fsSL https://raw.githubusercontent.com/MhankBarBar/zero-ichi/master/install.sh | bash

Windows (PowerShell):

powershell
irm https://raw.githubusercontent.com/MhankBarBar/zero-ichi/master/install.ps1 | iex

Custom Install Directory

Set INSTALL_DIR to change the install location (defaults to ~/zero-ichi):

bash
INSTALL_DIR=/opt/zero-ichi curl -fsSL https://raw.githubusercontent.com/MhankBarBar/zero-ichi/master/install.sh | bash

Requirements ​

  • Python 3.11+
  • uv — fast Python package manager
  • FFmpeg — required for audio/video processing
  • Bun — required for YouTube JS challenge solving (yt-dlp) and dashboard package scripts

Manual Install ​

bash
# Install uv (if not already installed)
pip install uv

# Clone the repository
git clone https://github.com/MhankBarBar/zero-ichi
cd zero-ichi

# Install dependencies
uv sync

Environment Setup ​

Copy the example environment file:

bash
cp .env.example .env

Edit .env with your values:

bash
AI_API_KEY=your_api_key_here
DATABASE_URL=
DASHBOARD_USERNAME=change_me
DASHBOARD_PASSWORD=change_me_too

TIP

The AI API key is only required if you plan to use the Agentic AI feature.

If DATABASE_URL is empty, Zero Ichi uses SQLite at data/zeroichi.db. Set a PostgreSQL URL to run on Postgres.

Next Steps ​

Quick run examples:

bash
uv run zero-ichi setup
uv run zero-ichi --debug
uv run zero-ichi --dashboard
uv run zero-ichi --phone 6281234567890

Built with ❤️

© 2026 MhankBarBar