Stop hiring engineers.
Start shipping products.

An AI engineering company in your terminal. Not a chatbot.
_{Powered by GitHub Copilot SDK  ·  Open Source  ·  MIT License}

Install   ·   Demo   ·   Features   ·   Architecture   ·   Website   ·   PyPI

pip install hauba && hauba init && hauba run "build me a SaaS"

One command gives you an AI team that plans architecture, writes production code, runs tests, fixes bugs, and delivers — while you sleep.

The same AI backbone used by GitHub. Now open-source and in your hands.

Your API key. Your machine. Zero platform cost.

We call this BYOK — Bring Your Own Key. The server is just a message queue. Builds always happen on your machine, with your credentials, under your control. Hauba charges nothing. Ever.

Install

pip install hauba

pip install hauba[all]            # everything
pip install hauba[computer-use]   # browser + screen automation
pip install hauba[voice]          # voice mode (Whisper + TTS)
pip install hauba[web]            # web dashboard (FastAPI)
pip install hauba[channels]       # WhatsApp, Telegram, Discord
pip install hauba[services]       # email (SMTP)

Requirements: Python 3.11+ — nothing else. No Docker. No Redis. No Kubernetes.

Quickstart

hauba init                                          # pick provider, paste key — 30 seconds
hauba run "build a SaaS dashboard with auth"        # it plans, you approve, it ships

$ hauba run "build a SaaS dashboard with auth"

  Thinking...
  Matched skills: full-stack-engineering, api-design, testing

  Plan
  ----
  1. Set up project structure
  2. Implement JWT authentication
  3. Build dashboard components
  4. Add Stripe billing integration
  5. Write test suite
  6. Verify all tests pass

  Proceed? [Y/n] y

  Executing (5/6)...
  [file] src/auth/handler.py          CREATED
  [file] src/billing/stripe.py        CREATED
  [bash] pytest tests/ -v             PASSED (12 tests)

  ✓ Task completed — 8 files created, 12 tests passing, 0 errors

Session stays open. Keep building:

> "add rate limiting and CORS"
> "write a Dockerfile for production"
> "deploy to Railway"

See It Work

Run a task Think → Plan → Execute → Verify → Deliver	30-second setup Pick provider → Paste key → Ready to ship
24/7 daemon agent Polls → Claims → Builds locally → Notifies on phone	WhatsApp command center Message bot → Queued → Built on your machine → Results delivered
Compose AI teams Architect → Backend ∥ Frontend → DevOps	Queue + Poll architecture Your machine ↔ Server relay ↔ Channels

Capabilities

How It Works

From idea to production in 3 steps.

Two modes of operation

Local CLI — you're at your computer:

hauba run "build me a landing page" → plans → you approve → builds → done

Queue + Poll — you're on your phone:

WhatsApp message → server queues it → your daemon picks it up
→ builds on YOUR machine with YOUR key → notifies you when done

┌─────────────────────┐         ┌─────────────────────┐
│   YOUR PHONE        │         │   YOUR MACHINE      │
│                     │         │                     │
│   WhatsApp          │         │   hauba agent       │
│   Telegram  ────────┼────►    │     ├─ poll         │
│   Discord           │  task   │     ├─ claim        │
│                     │  queue  │     ├─ build (BYOK) │
│   ◄─────────────────┼─────── │     └─ notify       │
│   "Done! 8 files"   │ result  │                     │
└─────────────────────┘         └─────────────────────┘
                    ▲                     │
                    │    hauba.tech       │
                    └──── (relay) ────────┘

The server never sees your API key. It's a stateless relay.

Daemon Agent

Your AI engineer that runs 24/7. Never sleeps. Never takes PTO.

hauba agent --server https://hauba.tech

Channels

WhatsApp · Telegram · Discord

Message your bot. Get results on your phone. 12 commands:

Smart routing: build requests go to queue, chat gets instant responses.

hauba setup whatsapp    # interactive Twilio wizard

Compose

docker-compose for AI agents. Define your team. Let them build.

# hauba.yaml
team: "my-saas"
model: "claude-sonnet-4-5-20250929"

agents:
  architect:
    role: "Senior Software Architect"
    skills: [system-design, api-design]

  backend:
    role: "Backend Engineer"
    skills: [fastapi, auth, database]
    depends_on: [architect]

  frontend:
    role: "Frontend Engineer"
    skills: [nextjs, tailwind, react]
    depends_on: [architect]

  devops:
    role: "DevOps Engineer"
    skills: [docker, ci-cd, monitoring]
    depends_on: [backend, frontend]

output: "./output"

hauba compose up "build a SaaS with auth and Stripe billing"

Backend + frontend run in parallel. DevOps waits for both. Circular dependency detection built in.

Skills

17 built-in. Human-readable .md files. Install your own.

hauba skill list                    # see all
hauba skill show full-stack         # inspect
hauba skill install ./custom.md     # add yours
hauba skill create my-skill         # scaffold

TaskLedger

Zero trust. Full verification. Every task passes 5 cryptographic gates:

 GATE 1   PRE-EXECUTION       Ledger must exist before work begins
 GATE 2   DEPENDENCY           All upstream tasks VERIFIED
 GATE 3   COMPLETION           SHA256(prev_hash + task_id + artifact_hash)
 GATE 4   DELIVERY             Full gate check at every level
 GATE 5   RECONCILIATION       plan_count === ledger_count

Bit-vector state tracking. SHA-256 hash chain. Write-Ahead Log. Crash-safe. Tamper-evident.

Plugins

Extend Hauba with async Python plugins. 7 lifecycle hooks.

from hauba.plugins.base import BasePlugin

class MyPlugin(BasePlugin):
    name = "my-plugin"

    async def on_message(self, channel, sender, text):
        if "urgent" in text.lower():
            return "Prioritizing your task!"
        return None

    async def on_task_complete(self, task_id, output):
        ...  # your logic

def create_plugin():
    return MyPlugin()

hauba plugins install ./my_plugin.py
hauba plugins list
hauba plugins remove my-plugin

Hooks: on_load · on_unload · on_message · on_task_complete · on_task_queued · on_startup · on_shutdown

Supported Models

hauba config llm.provider anthropic
hauba config llm.model claude-sonnet-4-5-20250929

Architecture

                    ┌───────────────────────────┐
                    │         CHANNELS           │
                    │  WhatsApp · Telegram       │
                    │  Discord · Voice · Web     │
                    └─────────────┬─────────────┘
                                  │
                           ┌──────▼──────┐
                           │   SERVER    │  hauba.tech
                           │  Task Queue │  relay only
                           │  Webhooks   │  zero builds
                           └──────┬──────┘
                                  │ poll 10s
                           ┌──────▼──────┐
                           │   DAEMON    │  your machine
                           │  CopilotSDK │  YOUR key
                           │  17 skills  │  TF-IDF match
                           │  TaskLedger │  SHA-256
                           └─────────────┘

src/hauba/
├── cli.py                     # 20+ commands (Typer + Rich)
├── engine/copilot_engine.py   # Core — GitHub Copilot SDK
├── daemon/
│   ├── agent.py               # 24/7 polling daemon
│   └── queue.py               # Task queue with TTL + retry
├── channels/
│   ├── whatsapp_webhook.py    # WhatsApp bot (12 commands)
│   ├── telegram.py            # Telegram
│   ├── discord.py             # Discord
│   └── voice.py               # Whisper STT + edge-tts
├── skills/
│   ├── loader.py              # .md parser
│   └── matcher.py             # TF-IDF matching
├── plugins/                   # base · loader · registry
├── ledger/
│   ├── tracker.py             # bit-vector + hash chain
│   ├── wal.py                 # Write-Ahead Log
│   └── gates.py               # 5 verification gates
├── memory/store.py            # SQLite + TTL + compaction
├── services/
│   ├── email.py               # SMTP
│   └── reply_assistant.py     # auto-reply
├── tools/                     # bash · files · git · fetch · browser · screen
├── compose/                   # hauba.yaml parser + DAG runner
├── core/                      # config · constants · events
├── ui/                        # Rich terminal + FastAPI web
└── bundled_skills/            # 17 .md files

CORE
  hauba init                              setup wizard
  hauba run "task" [--no-interactive]     execute a task
  hauba status                            config + last task
  hauba doctor                            system diagnostics
  hauba logs [--lines 50]                 view logs
  hauba config <key> [value]              get/set config

DAEMON
  hauba agent [--server URL]              start 24/7 daemon
  hauba tasks [--server URL]              list tasks
  hauba cancel <task_id>                  cancel task
  hauba retry <task_id>                   retry task
  hauba usage                             cost summary

COMPOSE
  hauba compose up "task" [-f file]       run agent team
  hauba compose validate [-f file]        validate yaml

SKILLS
  hauba skill list                        list skills
  hauba skill show <name>                 inspect skill
  hauba skill install <path>              add skill
  hauba skill create <name>               scaffold skill

PLUGINS
  hauba plugins list                      list plugins
  hauba plugins install <path.py>         add plugin
  hauba plugins remove <name>             remove plugin

CHANNELS
  hauba setup whatsapp                    whatsapp wizard
  hauba email <to> <subj> [body]          send email
  hauba web <url>                         fetch url
  hauba reply <message|off>               auto-reply
  hauba feedback <message>                feedback

UI
  hauba voice                             voice mode
  hauba serve [--port 8420]               web dashboard
  hauba api [--port 8080]                 REST API
  hauba replay <id> [--speed 2]           replay session

Deployment

Server runs at hauba.tech on Railway. Handles webhooks and task queuing. All builds execute on user machines.

TWILIO_ACCOUNT_SID=...
TWILIO_AUTH_TOKEN=...
TWILIO_WHATSAPP_NUMBER=whatsapp:+1...
HAUBA_LLM_API_KEY=...                  # server chat only
HAUBA_SMTP_HOST=smtp.gmail.com         # optional

Testing

pytest tests/ -v                       # 432 tests, 0 failures

Contributing

git clone https://github.com/NikeGunn/haubaa.git && cd haubaa
pip install -e ".[dev]" && pytest tests/ -v

Conventional commits: feat: · fix: · refactor: · test: · docs:

See CONTRIBUTING.md.

_{MIT License — LICENSE}

Stop hiring. Start shipping.

Website  ·  PyPI  ·  Issues  ·  Releases

_{Built by Nikhil Bhagat and community  ·  Powered by GitHub Copilot SDK}