hauba 0.1.0__tar.gz

hauba-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Type checking
+.pyright/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Environment
+.env
+.env.local
+
+# Hauba data (user-specific)
+~/.hauba/
+
+# SQLite databases
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+
+# Ruff cache
+.ruff_cache/
+
+# Docs (generated/internal)
+ARCHITECTURE_V2.md
+BUILD_PHASES_V2.md
+PROGRESS.md
+workflow-guidelines.md

hauba-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hauba AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hauba-0.1.0/PKG-INFO

@@ -0,0 +1,325 @@
+Metadata-Version: 2.4
+Name: hauba
+Version: 0.1.0
+Summary: Your AI Engineering Team — In One Command
+Project-URL: Homepage, https://github.com/NikeGunn/haubaa
+Project-URL: Documentation, https://github.com/NikeGunn/haubaa#readme
+Project-URL: Repository, https://github.com/NikeGunn/haubaa
+Project-URL: Issues, https://github.com/NikeGunn/haubaa/issues
+Project-URL: Changelog, https://github.com/NikeGunn/haubaa/releases
+Author: Hauba AI
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,automation,llm,multi-agent,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite<1.0,>=0.20
+Requires-Dist: anyio<5.0,>=4.0
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: litellm<2.0,>=1.40
+Requires-Dist: pydantic<3.0,>=2.5
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: rich<14.0,>=13.0
+Requires-Dist: structlog<25.0,>=24.1
+Requires-Dist: typer<1.0,>=0.12
+Provides-Extra: all
+Requires-Dist: discord-py<3.0,>=2.3; extra == 'all'
+Requires-Dist: edge-tts<7.0,>=6.1; extra == 'all'
+Requires-Dist: fastapi<1.0,>=0.110; extra == 'all'
+Requires-Dist: openai-whisper>=20231117; extra == 'all'
+Requires-Dist: pillow<11.0,>=10.0; extra == 'all'
+Requires-Dist: playwright<2.0,>=1.40; extra == 'all'
+Requires-Dist: pyautogui<1.0,>=0.9; extra == 'all'
+Requires-Dist: python-telegram-bot<22.0,>=21.0; extra == 'all'
+Requires-Dist: sounddevice<1.0,>=0.4; extra == 'all'
+Requires-Dist: uvicorn<1.0,>=0.27; extra == 'all'
+Requires-Dist: websockets<14.0,>=12.0; extra == 'all'
+Provides-Extra: channels
+Requires-Dist: discord-py<3.0,>=2.3; extra == 'channels'
+Requires-Dist: python-telegram-bot<22.0,>=21.0; extra == 'channels'
+Provides-Extra: computer-use
+Requires-Dist: pillow<11.0,>=10.0; extra == 'computer-use'
+Requires-Dist: playwright<2.0,>=1.40; extra == 'computer-use'
+Requires-Dist: pyautogui<1.0,>=0.9; extra == 'computer-use'
+Provides-Extra: dev
+Requires-Dist: pre-commit<4.0,>=3.7; extra == 'dev'
+Requires-Dist: pyright<2.0,>=1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio<1.0,>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov<6.0,>=5.0; extra == 'dev'
+Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
+Requires-Dist: ruff<1.0,>=0.5; extra == 'dev'
+Provides-Extra: voice
+Requires-Dist: edge-tts<7.0,>=6.1; extra == 'voice'
+Requires-Dist: openai-whisper>=20231117; extra == 'voice'
+Requires-Dist: sounddevice<1.0,>=0.4; extra == 'voice'
+Provides-Extra: web
+Requires-Dist: fastapi<1.0,>=0.110; extra == 'web'
+Requires-Dist: uvicorn<1.0,>=0.27; extra == 'web'
+Requires-Dist: websockets<14.0,>=12.0; extra == 'web'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <h1 align="center">Hauba</h1>
+  <p align="center"><strong>Your AI Engineering Team — In One Command</strong></p>
+  <p align="center">
+    <a href="https://github.com/NikeGunn/haubaa/actions"><img src="https://github.com/NikeGunn/haubaa/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+    <a href="https://pypi.org/project/hauba/"><img src="https://img.shields.io/pypi/v/hauba.svg" alt="PyPI"></a>
+    <a href="https://pypi.org/project/hauba/"><img src="https://img.shields.io/pypi/pyversions/hauba.svg" alt="Python"></a>
+    <a href="https://github.com/NikeGunn/haubaa/blob/main/LICENSE"><img src="https://img.shields.io/github/license/NikeGunn/haubaa.svg" alt="License"></a>
+  </p>
+  <p align="center">
+    <a href="#install">Install</a> &bull;
+    <a href="#quickstart">Quickstart</a> &bull;
+    <a href="#features">Features</a> &bull;
+    <a href="#architecture">Architecture</a> &bull;
+    <a href="CONTRIBUTING.md">Contributing</a>
+  </p>
+</p>
+
+---
+
+Hauba is an open-source AI agent framework that orchestrates a full engineering team — architect, backend, frontend, DevOps — controlled by a Director agent that **thinks before it acts**.
+
+One command. Zero external dependencies. Works offline with Ollama.
+
+```bash
+pip install hauba
+hauba init
+hauba run "build me a landing page with modern design"
+```
+
+## Why Hauba?
+
+| Feature | Hauba | Others |
+|---------|-------|--------|
+| Multi-agent collaboration | Director → SubAgent → Worker hierarchy | Single agent or basic chains |
+| Zero-hallucination tracking | TaskLedger with SHA-256 hash verification | Trust-based, no verification |
+| Works offline | First-class Ollama support | Requires cloud API |
+| Declarative teams | `hauba.yaml` (like docker-compose for AI) | Code-only configuration |
+| Browser automation | Persistent sessions, stealth mode, crash recovery | Basic or none |
+| Voice mode | Talk to your AI team | Text-only |
+| Replay mode | Watch & share agent sessions | No replay |
+| Single install | `pip install hauba` — no Docker, Redis, or Postgres | Complex setup |
+
+## Install
+
+```bash
+# From PyPI (recommended)
+pip install hauba
+
+# From source
+git clone https://github.com/NikeGunn/haubaa.git
+cd haubaa
+pip install -e ".[dev]"
+
+# Optional extras
+pip install hauba[computer-use]   # Browser + screen control
+pip install hauba[voice]          # Voice mode (Whisper + TTS)
+pip install hauba[web]            # Web dashboard
+pip install hauba[all]            # Everything
+```
+
+**Requirements:** Python 3.11+ — nothing else.
+
+## Quickstart
+
+### 1. Initialize
+
+```bash
+hauba init
+```
+
+Pick your LLM provider (Anthropic, OpenAI, Ollama, DeepSeek) and enter your API key.
+
+### 2. Run a task
+
+```bash
+hauba run "create a REST API with user authentication"
+```
+
+The Director agent will:
+1. **Deliberate** — understand your request and assess complexity
+2. **Plan** — decompose into steps with a dependency DAG
+3. **Execute** — use tools (bash, files, git, browser) to build it
+4. **Verify** — TaskLedger ensures every step completed with hash verification
+5. **Deliver** — only after all 5 verification gates pass
+
+### 3. Check system health
+
+```bash
+hauba doctor
+```
+
+## Hauba Compose
+
+Define your AI team declaratively:
+
+```yaml
+# hauba.yaml
+team: "my-saas"
+model: "claude-sonnet-4-5-20250929"
+
+agents:
+  architect:
+    role: "Senior Software Architect"
+    skills: [system-design, database-design, api-design]
+
+  backend:
+    role: "Backend Engineer"
+    skills: [fastapi, postgresql, auth]
+    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]
+```
+
+```bash
+hauba compose up "build a SaaS dashboard with auth and billing"
+```
+
+## Features
+
+### Multi-Agent Hierarchy
+- **Director** — receives your task, deliberates, creates a project plan
+- **SubAgent** — manages a milestone, coordinates workers
+- **Worker** — executes specific tasks with retry logic
+- **CoWorker** — ephemeral helpers for sub-tasks
+
+### TaskLedger (Zero-Hallucination System)
+Every task is tracked with a bit-vector and SHA-256 hash chain. Five verification gates ensure nothing is skipped or faked:
+1. **Pre-execution** — Ledger must exist before work begins
+2. **Dependency** — All dependencies verified before task starts
+3. **Completion** — Output hashed and verified on disk
+4. **Delivery** — Full ledger gate check at each level
+5. **Reconciliation** — Plan count matches ledger count
+
+### Browser Automation (Persistent Sessions)
+```bash
+hauba run "scrape product data from the competitor website"
+```
+- Persistent browser context — sessions survive crashes
+- Stealth mode — anti-bot detection evasion
+- Auto-retry with crash recovery
+
+### Voice Mode
+```bash
+hauba voice
+```
+Talk to your AI team. Uses Whisper (local) for speech-to-text and edge-tts for responses. Works fully offline with Ollama.
+
+### Replay Mode
+```bash
+hauba replay <task_id>
+hauba replay <task_id> --speed 5
+```
+Every agent action is recorded and replayable with speed control.
+
+### Skills & Strategies
+10 built-in skills and 6 strategies ship with Hauba:
+```bash
+hauba skill list                    # See all available skills
+hauba skill show code-generation    # View a skill's details
+hauba skill install ./my-skill.md   # Install a custom skill
+```
+
+### Web Dashboard
+```bash
+hauba serve
+```
+Real-time web dashboard with WebSocket event streaming at `http://localhost:8420`.
+
+### Channels
+```bash
+hauba voice      # Voice conversation
+hauba serve      # Web dashboard
+```
+Plus Telegram and Discord bot integrations.
+
+## CLI Reference
+
+```
+hauba init                          # Interactive setup wizard
+hauba run "task description"        # Execute a task
+hauba status                        # Show config and status
+hauba doctor                        # Diagnose setup issues
+hauba logs                          # View recent logs
+hauba config <key> [value]          # Get/set configuration
+
+hauba compose up "task" [-f file]   # Run with agent team
+hauba compose validate              # Check hauba.yaml syntax
+
+hauba skill list                    # List all skills
+hauba skill show <name>             # View skill details
+hauba skill install <path>          # Install a skill
+hauba skill create <name>           # Scaffold new skill
+
+hauba voice                         # Voice conversation mode
+hauba serve [--port 8420]           # Start web dashboard
+hauba replay <task_id> [--speed 2]  # Replay a session
+```
+
+## Configuration
+
+```bash
+# Anthropic (default)
+hauba config llm.provider anthropic
+hauba config llm.api_key sk-ant-...
+
+# OpenAI
+hauba config llm.provider openai
+hauba config llm.api_key sk-...
+
+# Ollama (offline, free)
+hauba config llm.provider ollama
+hauba config llm.model llama3.2
+```
+
+## Architecture
+
+```
+Director (1 per task)
+├── SubAgent (per milestone)
+│   ├── Worker (per task)
+│   │   └── CoWorker (ephemeral)
+│   └── Worker
+└── SubAgent
+    └── Worker
+```
+
+**Stack:** Python 3.11+ | asyncio | SQLite | litellm | Typer | Rich | Pydantic v2
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+```bash
+git clone https://github.com/NikeGunn/haubaa.git
+cd haubaa
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <strong>Hauba doesn't guess. Hauba verifies.</strong>
+</p>

hauba-0.1.0/README.md

@@ -0,0 +1,257 @@
+<p align="center">
+  <h1 align="center">Hauba</h1>
+  <p align="center"><strong>Your AI Engineering Team — In One Command</strong></p>
+  <p align="center">
+    <a href="https://github.com/NikeGunn/haubaa/actions"><img src="https://github.com/NikeGunn/haubaa/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+    <a href="https://pypi.org/project/hauba/"><img src="https://img.shields.io/pypi/v/hauba.svg" alt="PyPI"></a>
+    <a href="https://pypi.org/project/hauba/"><img src="https://img.shields.io/pypi/pyversions/hauba.svg" alt="Python"></a>
+    <a href="https://github.com/NikeGunn/haubaa/blob/main/LICENSE"><img src="https://img.shields.io/github/license/NikeGunn/haubaa.svg" alt="License"></a>
+  </p>
+  <p align="center">
+    <a href="#install">Install</a> &bull;
+    <a href="#quickstart">Quickstart</a> &bull;
+    <a href="#features">Features</a> &bull;
+    <a href="#architecture">Architecture</a> &bull;
+    <a href="CONTRIBUTING.md">Contributing</a>
+  </p>
+</p>
+
+---
+
+Hauba is an open-source AI agent framework that orchestrates a full engineering team — architect, backend, frontend, DevOps — controlled by a Director agent that **thinks before it acts**.
+
+One command. Zero external dependencies. Works offline with Ollama.
+
+```bash
+pip install hauba
+hauba init
+hauba run "build me a landing page with modern design"
+```
+
+## Why Hauba?
+
+| Feature | Hauba | Others |
+|---------|-------|--------|
+| Multi-agent collaboration | Director → SubAgent → Worker hierarchy | Single agent or basic chains |
+| Zero-hallucination tracking | TaskLedger with SHA-256 hash verification | Trust-based, no verification |
+| Works offline | First-class Ollama support | Requires cloud API |
+| Declarative teams | `hauba.yaml` (like docker-compose for AI) | Code-only configuration |
+| Browser automation | Persistent sessions, stealth mode, crash recovery | Basic or none |
+| Voice mode | Talk to your AI team | Text-only |
+| Replay mode | Watch & share agent sessions | No replay |
+| Single install | `pip install hauba` — no Docker, Redis, or Postgres | Complex setup |
+
+## Install
+
+```bash
+# From PyPI (recommended)
+pip install hauba
+
+# From source
+git clone https://github.com/NikeGunn/haubaa.git
+cd haubaa
+pip install -e ".[dev]"
+
+# Optional extras
+pip install hauba[computer-use]   # Browser + screen control
+pip install hauba[voice]          # Voice mode (Whisper + TTS)
+pip install hauba[web]            # Web dashboard
+pip install hauba[all]            # Everything
+```
+
+**Requirements:** Python 3.11+ — nothing else.
+
+## Quickstart
+
+### 1. Initialize
+
+```bash
+hauba init
+```
+
+Pick your LLM provider (Anthropic, OpenAI, Ollama, DeepSeek) and enter your API key.
+
+### 2. Run a task
+
+```bash
+hauba run "create a REST API with user authentication"
+```
+
+The Director agent will:
+1. **Deliberate** — understand your request and assess complexity
+2. **Plan** — decompose into steps with a dependency DAG
+3. **Execute** — use tools (bash, files, git, browser) to build it
+4. **Verify** — TaskLedger ensures every step completed with hash verification
+5. **Deliver** — only after all 5 verification gates pass
+
+### 3. Check system health
+
+```bash
+hauba doctor
+```
+
+## Hauba Compose
+
+Define your AI team declaratively:
+
+```yaml
+# hauba.yaml
+team: "my-saas"
+model: "claude-sonnet-4-5-20250929"
+
+agents:
+  architect:
+    role: "Senior Software Architect"
+    skills: [system-design, database-design, api-design]
+
+  backend:
+    role: "Backend Engineer"
+    skills: [fastapi, postgresql, auth]
+    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]
+```
+
+```bash
+hauba compose up "build a SaaS dashboard with auth and billing"
+```
+
+## Features
+
+### Multi-Agent Hierarchy
+- **Director** — receives your task, deliberates, creates a project plan
+- **SubAgent** — manages a milestone, coordinates workers
+- **Worker** — executes specific tasks with retry logic
+- **CoWorker** — ephemeral helpers for sub-tasks
+
+### TaskLedger (Zero-Hallucination System)
+Every task is tracked with a bit-vector and SHA-256 hash chain. Five verification gates ensure nothing is skipped or faked:
+1. **Pre-execution** — Ledger must exist before work begins
+2. **Dependency** — All dependencies verified before task starts
+3. **Completion** — Output hashed and verified on disk
+4. **Delivery** — Full ledger gate check at each level
+5. **Reconciliation** — Plan count matches ledger count
+
+### Browser Automation (Persistent Sessions)
+```bash
+hauba run "scrape product data from the competitor website"
+```
+- Persistent browser context — sessions survive crashes
+- Stealth mode — anti-bot detection evasion
+- Auto-retry with crash recovery
+
+### Voice Mode
+```bash
+hauba voice
+```
+Talk to your AI team. Uses Whisper (local) for speech-to-text and edge-tts for responses. Works fully offline with Ollama.
+
+### Replay Mode
+```bash
+hauba replay <task_id>
+hauba replay <task_id> --speed 5
+```
+Every agent action is recorded and replayable with speed control.
+
+### Skills & Strategies
+10 built-in skills and 6 strategies ship with Hauba:
+```bash
+hauba skill list                    # See all available skills
+hauba skill show code-generation    # View a skill's details
+hauba skill install ./my-skill.md   # Install a custom skill
+```
+
+### Web Dashboard
+```bash
+hauba serve
+```
+Real-time web dashboard with WebSocket event streaming at `http://localhost:8420`.
+
+### Channels
+```bash
+hauba voice      # Voice conversation
+hauba serve      # Web dashboard
+```
+Plus Telegram and Discord bot integrations.
+
+## CLI Reference
+
+```
+hauba init                          # Interactive setup wizard
+hauba run "task description"        # Execute a task
+hauba status                        # Show config and status
+hauba doctor                        # Diagnose setup issues
+hauba logs                          # View recent logs
+hauba config <key> [value]          # Get/set configuration
+
+hauba compose up "task" [-f file]   # Run with agent team
+hauba compose validate              # Check hauba.yaml syntax
+
+hauba skill list                    # List all skills
+hauba skill show <name>             # View skill details
+hauba skill install <path>          # Install a skill
+hauba skill create <name>           # Scaffold new skill
+
+hauba voice                         # Voice conversation mode
+hauba serve [--port 8420]           # Start web dashboard
+hauba replay <task_id> [--speed 2]  # Replay a session
+```
+
+## Configuration
+
+```bash
+# Anthropic (default)
+hauba config llm.provider anthropic
+hauba config llm.api_key sk-ant-...
+
+# OpenAI
+hauba config llm.provider openai
+hauba config llm.api_key sk-...
+
+# Ollama (offline, free)
+hauba config llm.provider ollama
+hauba config llm.model llama3.2
+```
+
+## Architecture
+
+```
+Director (1 per task)
+├── SubAgent (per milestone)
+│   ├── Worker (per task)
+│   │   └── CoWorker (ephemeral)
+│   └── Worker
+└── SubAgent
+    └── Worker
+```
+
+**Stack:** Python 3.11+ | asyncio | SQLite | litellm | Typer | Rich | Pydantic v2
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+```bash
+git clone https://github.com/NikeGunn/haubaa.git
+cd haubaa
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">
+  <strong>Hauba doesn't guess. Hauba verifies.</strong>
+</p>