hyperclaw 0.1.0a0__tar.gz

hyperclaw-0.1.0a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hyper Nimbus
+
+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.

hyperclaw-0.1.0a0/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: hyperclaw
+Version: 0.1.0a0
+Summary: Unlimited-domain multi-agent AI swarm platform
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: asyncpg>=0.29
+Requires-Dist: pgvector>=0.2
+Requires-Dist: httpx>=0.27
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=0.61
+Requires-Dist: anthropic>=0.28
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: fastapi>=0.109
+Requires-Dist: uvicorn[standard]>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Dynamic: license-file
+
+# HyperClaw
+
+**Your personal AI that actually gets things done.**
+
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+
+HyperClaw is a personal AI assistant that works across your entire life. Not just chat — it connects to your email, calendar, tasks, documents, and more. It remembers everything, learns your preferences, and coordinates 50+ specialized AI agents to help you with anything.
+
+---
+
+## What Can It Do?
+
+- **Manage your communications** — Email, Telegram, Slack, Discord, WhatsApp, Teams
+- **Organize your work** — Calendar, tasks, projects, documents
+- **Handle your data** — Notion, Airtable, Google Sheets, Salesforce, HubSpot
+- **Support your business** — Invoicing, customer tracking, sales pipelines
+- **Research anything** — Web search, document analysis, data synthesis
+- **Remember everything** — Your preferences, history, context across all sessions
+
+One AI. Every platform. All working together.
+
+---
+
+## Getting Started
+
+### Option 1: Quick Start (5 minutes)
+
+```bash
+# Install
+pip install hyperclaw
+
+# Run setup
+hyperclaw init
+```
+
+The setup walks you through everything — no technical knowledge needed.
+
+### Option 2: Self-Host with Docker
+
+```bash
+# Clone the repo
+git clone https://github.com/mentatalbans/hyperclaw.git
+cd hyperclaw
+
+# Copy the example config
+cp .env.example .env
+
+# Edit .env and add your Anthropic API key
+# ANTHROPIC_API_KEY=sk-ant-your-key
+
+# Start
+docker-compose up
+```
+
+Open `http://localhost:8000` in your browser.
+
+### Option 3: One-Click Cloud Deploy
+
+Deploy to your favorite cloud platform:
+
+| Platform | Deploy |
+|----------|--------|
+| Railway | [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/hyperclaw) |
+| Render | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/mentatalbans/hyperclaw) |
+| Fly.io | `fly launch` |
+
+---
+
+## What You Need
+
+### Required
+- **Anthropic API Key** — Powers the AI brain
+  - Get one free at [console.anthropic.com](https://console.anthropic.com)
+
+### Optional (but recommended)
+- **Database** — Enables memory across sessions
+  - Easiest: [Supabase](https://supabase.com) (free tier works great)
+  - Or: Any PostgreSQL with pgvector
+
+### Integrations (connect what you use)
+- **Messaging:** Telegram, Slack, Discord, WhatsApp, Teams
+- **Email:** Gmail, Outlook
+- **Productivity:** Google Calendar, Notion, Todoist, Linear
+- **Business:** Salesforce, HubSpot, Stripe, QuickBooks
+- **Developer:** GitHub, Jira
+
+See [.env.example](.env.example) for all available integrations.
+
+---
+
+## How It Works
+
+```
+You → NEXUS (orchestrator) → 50+ Specialist Agents → Results
+
+Example:
+"Schedule a meeting with my team next week and send invites"
+
+NEXUS coordinates:
+├── Calendar agent (finds available times)
+├── Email agent (drafts invites)
+├── Memory agent (recalls team preferences)
+└── Returns: "Meeting scheduled for Tuesday 2pm. Invites sent to 4 people."
+```
+
+### The Agents
+
+| Domain | What They Do |
+|--------|-------------|
+| Business | Finance, contracts, market analysis |
+| Communications | Email, messaging, scheduling |
+| Personal | Health, fitness, reminders |
+| Research | Web search, document analysis |
+| Creative | Writing, design, brainstorming |
+| Technical | Code, debugging, architecture |
+
+---
+
+## Commands
+
+```bash
+hyperclaw init          # First-time setup (guided)
+hyperclaw start         # Start the system
+hyperclaw doctor        # Check if everything's working
+
+hyperclaw swarm "..."   # Ask anything
+hyperclaw agent         # List all agents
+hyperclaw integrations  # Manage connections
+```
+
+---
+
+## Dashboard
+
+HyperClaw includes a web dashboard at `http://localhost:8000`:
+
+- **Chat** — Talk to NEXUS
+- **Integrations** — Connect your services with visual setup wizards
+- **Agents** — See all 50+ specialists
+- **Memory** — View what HyperClaw remembers
+- **Settings** — Configure your system
+
+---
+
+## Privacy & Security
+
+- **Your data stays yours** — Self-host means nothing leaves your machine
+- **No tracking** — We don't collect anything
+- **Open source** — Audit the code yourself
+- **Per-agent permissions** — Control what each agent can access
+
+---
+
+## Troubleshooting
+
+**"API key not working"**
+- Make sure it starts with `sk-ant-`
+- Check for extra spaces when pasting
+
+**"Database connection failed"**
+- Verify your DATABASE_URL is correct
+- For Supabase, use the "Transaction pooler" connection string
+
+**"Integration not connecting"**
+- Run `hyperclaw integrations test <name>` to diagnose
+- Check that API keys are in your `.env` file
+
+**Need help?**
+- Run `hyperclaw doctor` to check system health
+- Open an issue on [GitHub](https://github.com/mentatalbans/hyperclaw/issues)
+
+---
+
+## Contributing
+
+MIT licensed. Contributions welcome.
+
+```bash
+git clone https://github.com/mentatalbans/hyperclaw.git
+cd hyperclaw
+pip install -e ".[dev]"
+python -m pytest tests/ -v
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT — use it, modify it, build on it.

hyperclaw-0.1.0a0/README.md

@@ -0,0 +1,192 @@
+# HyperClaw
+
+**Your personal AI that actually gets things done.**
+
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
+
+HyperClaw is a personal AI assistant that works across your entire life. Not just chat — it connects to your email, calendar, tasks, documents, and more. It remembers everything, learns your preferences, and coordinates 50+ specialized AI agents to help you with anything.
+
+---
+
+## What Can It Do?
+
+- **Manage your communications** — Email, Telegram, Slack, Discord, WhatsApp, Teams
+- **Organize your work** — Calendar, tasks, projects, documents
+- **Handle your data** — Notion, Airtable, Google Sheets, Salesforce, HubSpot
+- **Support your business** — Invoicing, customer tracking, sales pipelines
+- **Research anything** — Web search, document analysis, data synthesis
+- **Remember everything** — Your preferences, history, context across all sessions
+
+One AI. Every platform. All working together.
+
+---
+
+## Getting Started
+
+### Option 1: Quick Start (5 minutes)
+
+```bash
+# Install
+pip install hyperclaw
+
+# Run setup
+hyperclaw init
+```
+
+The setup walks you through everything — no technical knowledge needed.
+
+### Option 2: Self-Host with Docker
+
+```bash
+# Clone the repo
+git clone https://github.com/mentatalbans/hyperclaw.git
+cd hyperclaw
+
+# Copy the example config
+cp .env.example .env
+
+# Edit .env and add your Anthropic API key
+# ANTHROPIC_API_KEY=sk-ant-your-key
+
+# Start
+docker-compose up
+```
+
+Open `http://localhost:8000` in your browser.
+
+### Option 3: One-Click Cloud Deploy
+
+Deploy to your favorite cloud platform:
+
+| Platform | Deploy |
+|----------|--------|
+| Railway | [![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/hyperclaw) |
+| Render | [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/mentatalbans/hyperclaw) |
+| Fly.io | `fly launch` |
+
+---
+
+## What You Need
+
+### Required
+- **Anthropic API Key** — Powers the AI brain
+  - Get one free at [console.anthropic.com](https://console.anthropic.com)
+
+### Optional (but recommended)
+- **Database** — Enables memory across sessions
+  - Easiest: [Supabase](https://supabase.com) (free tier works great)
+  - Or: Any PostgreSQL with pgvector
+
+### Integrations (connect what you use)
+- **Messaging:** Telegram, Slack, Discord, WhatsApp, Teams
+- **Email:** Gmail, Outlook
+- **Productivity:** Google Calendar, Notion, Todoist, Linear
+- **Business:** Salesforce, HubSpot, Stripe, QuickBooks
+- **Developer:** GitHub, Jira
+
+See [.env.example](.env.example) for all available integrations.
+
+---
+
+## How It Works
+
+```
+You → NEXUS (orchestrator) → 50+ Specialist Agents → Results
+
+Example:
+"Schedule a meeting with my team next week and send invites"
+
+NEXUS coordinates:
+├── Calendar agent (finds available times)
+├── Email agent (drafts invites)
+├── Memory agent (recalls team preferences)
+└── Returns: "Meeting scheduled for Tuesday 2pm. Invites sent to 4 people."
+```
+
+### The Agents
+
+| Domain | What They Do |
+|--------|-------------|
+| Business | Finance, contracts, market analysis |
+| Communications | Email, messaging, scheduling |
+| Personal | Health, fitness, reminders |
+| Research | Web search, document analysis |
+| Creative | Writing, design, brainstorming |
+| Technical | Code, debugging, architecture |
+
+---
+
+## Commands
+
+```bash
+hyperclaw init          # First-time setup (guided)
+hyperclaw start         # Start the system
+hyperclaw doctor        # Check if everything's working
+
+hyperclaw swarm "..."   # Ask anything
+hyperclaw agent         # List all agents
+hyperclaw integrations  # Manage connections
+```
+
+---
+
+## Dashboard
+
+HyperClaw includes a web dashboard at `http://localhost:8000`:
+
+- **Chat** — Talk to NEXUS
+- **Integrations** — Connect your services with visual setup wizards
+- **Agents** — See all 50+ specialists
+- **Memory** — View what HyperClaw remembers
+- **Settings** — Configure your system
+
+---
+
+## Privacy & Security
+
+- **Your data stays yours** — Self-host means nothing leaves your machine
+- **No tracking** — We don't collect anything
+- **Open source** — Audit the code yourself
+- **Per-agent permissions** — Control what each agent can access
+
+---
+
+## Troubleshooting
+
+**"API key not working"**
+- Make sure it starts with `sk-ant-`
+- Check for extra spaces when pasting
+
+**"Database connection failed"**
+- Verify your DATABASE_URL is correct
+- For Supabase, use the "Transaction pooler" connection string
+
+**"Integration not connecting"**
+- Run `hyperclaw integrations test <name>` to diagnose
+- Check that API keys are in your `.env` file
+
+**Need help?**
+- Run `hyperclaw doctor` to check system health
+- Open an issue on [GitHub](https://github.com/mentatalbans/hyperclaw/issues)
+
+---
+
+## Contributing
+
+MIT licensed. Contributions welcome.
+
+```bash
+git clone https://github.com/mentatalbans/hyperclaw.git
+cd hyperclaw
+pip install -e ".[dev]"
+python -m pytest tests/ -v
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT — use it, modify it, build on it.

hyperclaw-0.1.0a0/cli/__init__.py

@@ -0,0 +1 @@
+# HyperClaw CLI

hyperclaw-0.1.0a0/cli/doctor.py

@@ -0,0 +1,196 @@
+"""
+hyperclaw doctor — system health check.
+Verifies API keys, DB connection, pgvector, policy files, and dependencies.
+"""
+from __future__ import annotations
+
+import asyncio
+import importlib
+import os
+import sys
+from pathlib import Path
+from typing import Callable
+
+from rich.console import Console
+from rich.table import Table
+from rich import print as rprint
+
+console = Console()
+
+CHECK_MARK = "[bold green]✓[/bold green]"
+CROSS_MARK = "[bold red]✗[/bold red]"
+WARN_MARK  = "[bold yellow]⚠[/bold yellow]"
+
+
+def _check(label: str, ok: bool, detail: str = "", warn: bool = False) -> dict:
+    status = CHECK_MARK if ok else (WARN_MARK if warn else CROSS_MARK)
+    return {"label": label, "ok": ok, "warn": warn, "detail": detail, "status": status}
+
+
+async def _check_db(db_url: str) -> dict:
+    try:
+        import asyncpg
+        conn = await asyncpg.connect(db_url, timeout=5)
+        await conn.close()
+        return _check("PostgreSQL connection", True, db_url.split("@")[-1] if "@" in db_url else db_url)
+    except Exception as e:
+        return _check("PostgreSQL connection", False, str(e)[:80])
+
+
+async def _check_pgvector(db_url: str) -> dict:
+    try:
+        import asyncpg
+        conn = await asyncpg.connect(db_url, timeout=5)
+        row = await conn.fetchval(
+            "SELECT COUNT(*) FROM pg_extension WHERE extname = 'vector'"
+        )
+        await conn.close()
+        if row:
+            return _check("pgvector extension", True, "installed")
+        else:
+            return _check("pgvector extension", False,
+                         "Not installed — run: CREATE EXTENSION vector; in your DB", warn=True)
+    except Exception as e:
+        return _check("pgvector extension", False, str(e)[:80])
+
+
+async def _check_migrations(db_url: str) -> dict:
+    try:
+        import asyncpg
+        conn = await asyncpg.connect(db_url, timeout=5)
+        exists = await conn.fetchval(
+            "SELECT EXISTS(SELECT 1 FROM information_schema.tables WHERE table_name='_migrations')"
+        )
+        if exists:
+            applied = await conn.fetch("SELECT filename FROM _migrations ORDER BY filename")
+            names = [r["filename"] for r in applied]
+            await conn.close()
+            return _check("DB migrations", True, f"{len(names)} applied: {', '.join(names)}")
+        else:
+            await conn.close()
+            return _check("DB migrations", False,
+                         "Not initialized — run: hyperclaw init", warn=True)
+    except Exception as e:
+        return _check("DB migrations", False, str(e)[:80])
+
+
+def run_doctor() -> int:
+    """
+    Run all health checks and print results.
+    Returns 0 if all critical checks pass, 1 if any fail.
+    """
+    console.print("\n[bold cyan]⚡ HyperClaw Doctor[/bold cyan]\n")
+
+    checks: list[dict] = []
+    db_url = os.environ.get("DATABASE_URL", "")
+
+    # ── Python version ────────────────────────────────────────────────────────
+    py = sys.version_info
+    checks.append(_check(
+        "Python version",
+        py >= (3, 11),
+        f"{py.major}.{py.minor}.{py.micro}",
+        warn=(py >= (3, 11)),
+    ))
+
+    # ── Required packages ─────────────────────────────────────────────────────
+    required_packages = {
+        "pydantic": "pydantic",
+        "asyncpg": "asyncpg",
+        "anthropic": "anthropic",
+        "httpx": "httpx",
+        "typer": "typer",
+        "rich": "rich",
+        "yaml": "yaml (pyyaml)",
+        "dotenv": "dotenv (python-dotenv)",
+    }
+    for mod, label in required_packages.items():
+        try:
+            importlib.import_module(mod)
+            checks.append(_check(f"Package: {label}", True))
+        except ImportError:
+            checks.append(_check(f"Package: {label}", False, f"pip install {label.split()[0]}"))
+
+    # ── Environment variables ─────────────────────────────────────────────────
+    anthropic_key = os.environ.get("ANTHROPIC_API_KEY", "")
+    checks.append(_check(
+        "ANTHROPIC_API_KEY",
+        bool(anthropic_key),
+        f"sk-ant-...{anthropic_key[-6:]}" if anthropic_key else "Not set — export ANTHROPIC_API_KEY=...",
+    ))
+
+    db_url_env = os.environ.get("DATABASE_URL", "")
+    checks.append(_check(
+        "DATABASE_URL",
+        bool(db_url_env),
+        f"...{db_url_env[-30:]}" if db_url_env else "Not set — using config/hyperclaw.yaml fallback",
+        warn=not bool(db_url_env),
+    ))
+
+    chatjimmy_key = os.environ.get("CHATJIMMY_API_KEY", "")
+    checks.append(_check(
+        "CHATJIMMY_API_KEY",
+        bool(chatjimmy_key),
+        "Set" if chatjimmy_key else "Not set — ChatJimmy will be unavailable (optional)",
+        warn=not bool(chatjimmy_key),
+    ))
+
+    # ── Config files ──────────────────────────────────────────────────────────
+    config_files = [
+        "config/hyperclaw.yaml",
+        "config/agents.yaml",
+        "config/models.yaml",
+        "security/policies/default.yaml",
+    ]
+    for cf in config_files:
+        checks.append(_check(f"Config: {cf}", Path(cf).exists(),
+                            "Found" if Path(cf).exists() else f"Missing — run: hyperclaw init"))
+
+    # ── DB checks (async) ─────────────────────────────────────────────────────
+    if db_url_env:
+        loop = asyncio.new_event_loop()
+        try:
+            checks.append(loop.run_until_complete(_check_db(db_url_env)))
+            checks.append(loop.run_until_complete(_check_pgvector(db_url_env)))
+            checks.append(loop.run_until_complete(_check_migrations(db_url_env)))
+        finally:
+            loop.close()
+    else:
+        checks.append(_check("PostgreSQL connection", False,
+                            "Skipped — DATABASE_URL not set", warn=True))
+        checks.append(_check("pgvector extension", False,
+                            "Skipped — DATABASE_URL not set", warn=True))
+        checks.append(_check("DB migrations", False,
+                            "Skipped — DATABASE_URL not set", warn=True))
+
+    # ── Print results ─────────────────────────────────────────────────────────
+    table = Table(show_header=True, header_style="bold cyan", expand=True)
+    table.add_column("Check", style="bold")
+    table.add_column("Status", justify="center", width=4)
+    table.add_column("Detail", style="dim")
+
+    for c in checks:
+        table.add_row(c["label"], c["status"], c["detail"])
+
+    console.print(table)
+
+    failed = [c for c in checks if not c["ok"] and not c.get("warn")]
+    warned = [c for c in checks if not c["ok"] and c.get("warn")]
+    passed = [c for c in checks if c["ok"]]
+
+    console.print(
+        f"\n[green]{len(passed)} passed[/green]  "
+        f"[yellow]{len(warned)} warnings[/yellow]  "
+        f"[red]{len(failed)} failed[/red]"
+    )
+
+    if failed:
+        console.print("\n[red]Fix the failed checks above before running hyperclaw start.[/red]")
+        return 1
+
+    if not warned:
+        console.print("\n[bold green]✓ HyperClaw is healthy and ready to run.[/bold green]")
+    else:
+        console.print("\n[bold yellow]⚠ HyperClaw has warnings — review above before running tasks.[/bold yellow]")
+
+    return 0