hanzo 0.3.23__tar.gz → 0.3.24__tar.gz

hanzo-0.3.24/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: hanzo
+Version: 0.3.24
+Summary: Hanzo AI - Complete AI Infrastructure Platform with CLI, Router, MCP, and Agent Runtime
+Project-URL: Homepage, https://hanzo.ai
+Project-URL: Repository, https://github.com/hanzoai/python-sdk
+Project-URL: Documentation, https://docs.hanzo.ai/cli
+Project-URL: Bug Tracker, https://github.com/hanzoai/python-sdk/issues
+Author-email: Hanzo AI <dev@hanzo.ai>
+Keywords: agents,ai,cli,hanzo,llm,local-ai,mcp,private-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.25.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.23.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: agents
+Requires-Dist: hanzo-agents>=0.1.0; extra == 'agents'
+Requires-Dist: hanzo-network>=0.1.3; extra == 'agents'
+Provides-Extra: ai
+Requires-Dist: hanzoai>=1.0.0; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: hanzo-aci>=0.2.8; extra == 'all'
+Requires-Dist: hanzo-agents>=0.1.0; extra == 'all'
+Requires-Dist: hanzo-mcp>=0.7.0; extra == 'all'
+Requires-Dist: hanzo-memory>=1.0.0; extra == 'all'
+Requires-Dist: hanzo-network>=0.1.3; extra == 'all'
+Requires-Dist: hanzo-repl>=0.1.0; extra == 'all'
+Requires-Dist: hanzoai>=1.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: hanzo-aci>=0.2.8; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: hanzo-mcp>=0.7.0; extra == 'mcp'
+Provides-Extra: repl
+Requires-Dist: hanzo-repl>=0.1.0; extra == 'repl'
+Provides-Extra: router
+Description-Content-Type: text/markdown
+
+# Hanzo CLI and Orchestration Tools
+
+[![PyPI](https://img.shields.io/pypi/v/hanzo.svg)](https://pypi.org/project/hanzo/)
+[![Python Version](https://img.shields.io/pypi/pyversions/hanzo.svg)](https://pypi.org/project/hanzo/)
+
+Core CLI and orchestration tools for the Hanzo AI platform.
+
+## Installation
+
+```bash
+pip install hanzo
+```
+
+## Features
+
+- **Interactive Chat**: Chat with AI models through CLI
+- **Node Management**: Run local AI inference nodes
+- **Router Control**: Manage LLM proxy router
+- **REPL Interface**: Interactive Python REPL with AI
+- **Batch Orchestration**: Orchestrate multiple AI tasks
+- **Memory Management**: Persistent conversation memory
+
+## Usage
+
+### CLI Commands
+
+```bash
+# Interactive chat
+hanzo chat
+
+# Use specific model
+hanzo chat --model gpt-4
+
+# Use router (local proxy)
+hanzo chat --router
+
+# Use cloud API
+hanzo chat --cloud
+```
+
+### Node Management
+
+```bash
+# Start local node
+hanzo node start
+
+# Check status
+hanzo node status
+
+# List available models
+hanzo node models
+
+# Load specific model
+hanzo node load llama2:7b
+
+# Stop node
+hanzo node stop
+```
+
+### Router Management
+
+```bash
+# Start router proxy
+hanzo router start
+
+# Check router status
+hanzo router status
+
+# List available models
+hanzo router models
+
+# View configuration
+hanzo router config
+
+# Stop router
+hanzo router stop
+```
+
+### Interactive REPL
+
+```bash
+# Start REPL
+hanzo repl
+
+# In REPL:
+> /help              # Show help
+> /models            # List models
+> /model gpt-4       # Switch model
+> /clear             # Clear context
+> What is Python?    # Ask questions
+```
+
+## Python API
+
+### Batch Orchestration
+
+```python
+from hanzo.batch_orchestrator import BatchOrchestrator
+
+orchestrator = BatchOrchestrator()
+results = await orchestrator.run_batch([
+    "Summarize quantum computing",
+    "Explain machine learning",
+    "Define artificial intelligence"
+])
+```
+
+### Memory Management
+
+```python
+from hanzo.memory_manager import MemoryManager
+
+memory = MemoryManager()
+memory.add_to_context("user", "What is Python?")
+memory.add_to_context("assistant", "Python is...")
+context = memory.get_context()
+```
+
+### Fallback Handling
+
+```python
+from hanzo.fallback_handler import FallbackHandler
+
+handler = FallbackHandler()
+result = await handler.handle_with_fallback(
+    primary_fn=api_call,
+    fallback_fn=local_inference
+)
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# API settings
+HANZO_API_KEY=your-api-key
+HANZO_BASE_URL=https://api.hanzo.ai
+
+# Router settings
+HANZO_ROUTER_URL=http://localhost:4000/v1
+
+# Node settings
+HANZO_NODE_URL=http://localhost:8000/v1
+HANZO_NODE_WORKERS=4
+
+# Model preferences
+HANZO_DEFAULT_MODEL=gpt-4
+HANZO_FALLBACK_MODEL=llama2:7b
+```
+
+### Configuration File
+
+Create `~/.hanzo/config.yaml`:
+
+```yaml
+api:
+  key: your-api-key
+  base_url: https://api.hanzo.ai
+
+router:
+  url: http://localhost:4000/v1
+  auto_start: true
+
+node:
+  url: http://localhost:8000/v1
+  workers: 4
+  models:
+    - llama2:7b
+    - mistral:7b
+
+models:
+  default: gpt-4
+  fallback: llama2:7b
+```
+
+## Architecture
+
+### Components
+
+- **CLI**: Command-line interface (`cli.py`)
+- **Chat**: Interactive chat interface (`commands/chat.py`)
+- **Node**: Local AI node management (`commands/node.py`)
+- **Router**: LLM proxy management (`commands/router.py`)
+- **REPL**: Interactive Python REPL (`interactive/repl.py`)
+- **Orchestrator**: Batch task orchestration (`batch_orchestrator.py`)
+- **Memory**: Conversation memory (`memory_manager.py`)
+- **Fallback**: Resilient API handling (`fallback_handler.py`)
+
+### Port Allocation
+
+- **4000**: Router (LLM proxy)
+- **8000**: Node (local AI)
+- **9550-9553**: Desktop app integration
+
+## Development
+
+### Setup
+
+```bash
+cd pkg/hanzo
+uv sync --all-extras
+```
+
+### Testing
+
+```bash
+# Run tests
+pytest tests/
+
+# With coverage
+pytest tests/ --cov=hanzo
+```
+
+### Building
+
+```bash
+uv build
+```
+
+## License
+
+Apache License 2.0

hanzo-0.3.24/README.md

@@ -0,0 +1,223 @@
+# Hanzo CLI and Orchestration Tools
+
+[![PyPI](https://img.shields.io/pypi/v/hanzo.svg)](https://pypi.org/project/hanzo/)
+[![Python Version](https://img.shields.io/pypi/pyversions/hanzo.svg)](https://pypi.org/project/hanzo/)
+
+Core CLI and orchestration tools for the Hanzo AI platform.
+
+## Installation
+
+```bash
+pip install hanzo
+```
+
+## Features
+
+- **Interactive Chat**: Chat with AI models through CLI
+- **Node Management**: Run local AI inference nodes
+- **Router Control**: Manage LLM proxy router
+- **REPL Interface**: Interactive Python REPL with AI
+- **Batch Orchestration**: Orchestrate multiple AI tasks
+- **Memory Management**: Persistent conversation memory
+
+## Usage
+
+### CLI Commands
+
+```bash
+# Interactive chat
+hanzo chat
+
+# Use specific model
+hanzo chat --model gpt-4
+
+# Use router (local proxy)
+hanzo chat --router
+
+# Use cloud API
+hanzo chat --cloud
+```
+
+### Node Management
+
+```bash
+# Start local node
+hanzo node start
+
+# Check status
+hanzo node status
+
+# List available models
+hanzo node models
+
+# Load specific model
+hanzo node load llama2:7b
+
+# Stop node
+hanzo node stop
+```
+
+### Router Management
+
+```bash
+# Start router proxy
+hanzo router start
+
+# Check router status
+hanzo router status
+
+# List available models
+hanzo router models
+
+# View configuration
+hanzo router config
+
+# Stop router
+hanzo router stop
+```
+
+### Interactive REPL
+
+```bash
+# Start REPL
+hanzo repl
+
+# In REPL:
+> /help              # Show help
+> /models            # List models
+> /model gpt-4       # Switch model
+> /clear             # Clear context
+> What is Python?    # Ask questions
+```
+
+## Python API
+
+### Batch Orchestration
+
+```python
+from hanzo.batch_orchestrator import BatchOrchestrator
+
+orchestrator = BatchOrchestrator()
+results = await orchestrator.run_batch([
+    "Summarize quantum computing",
+    "Explain machine learning",
+    "Define artificial intelligence"
+])
+```
+
+### Memory Management
+
+```python
+from hanzo.memory_manager import MemoryManager
+
+memory = MemoryManager()
+memory.add_to_context("user", "What is Python?")
+memory.add_to_context("assistant", "Python is...")
+context = memory.get_context()
+```
+
+### Fallback Handling
+
+```python
+from hanzo.fallback_handler import FallbackHandler
+
+handler = FallbackHandler()
+result = await handler.handle_with_fallback(
+    primary_fn=api_call,
+    fallback_fn=local_inference
+)
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# API settings
+HANZO_API_KEY=your-api-key
+HANZO_BASE_URL=https://api.hanzo.ai
+
+# Router settings
+HANZO_ROUTER_URL=http://localhost:4000/v1
+
+# Node settings
+HANZO_NODE_URL=http://localhost:8000/v1
+HANZO_NODE_WORKERS=4
+
+# Model preferences
+HANZO_DEFAULT_MODEL=gpt-4
+HANZO_FALLBACK_MODEL=llama2:7b
+```
+
+### Configuration File
+
+Create `~/.hanzo/config.yaml`:
+
+```yaml
+api:
+  key: your-api-key
+  base_url: https://api.hanzo.ai
+
+router:
+  url: http://localhost:4000/v1
+  auto_start: true
+
+node:
+  url: http://localhost:8000/v1
+  workers: 4
+  models:
+    - llama2:7b
+    - mistral:7b
+
+models:
+  default: gpt-4
+  fallback: llama2:7b
+```
+
+## Architecture
+
+### Components
+
+- **CLI**: Command-line interface (`cli.py`)
+- **Chat**: Interactive chat interface (`commands/chat.py`)
+- **Node**: Local AI node management (`commands/node.py`)
+- **Router**: LLM proxy management (`commands/router.py`)
+- **REPL**: Interactive Python REPL (`interactive/repl.py`)
+- **Orchestrator**: Batch task orchestration (`batch_orchestrator.py`)
+- **Memory**: Conversation memory (`memory_manager.py`)
+- **Fallback**: Resilient API handling (`fallback_handler.py`)
+
+### Port Allocation
+
+- **4000**: Router (LLM proxy)
+- **8000**: Node (local AI)
+- **9550-9553**: Desktop app integration
+
+## Development
+
+### Setup
+
+```bash
+cd pkg/hanzo
+uv sync --all-extras
+```
+
+### Testing
+
+```bash
+# Run tests
+pytest tests/
+
+# With coverage
+pytest tests/ --cov=hanzo
+```
+
+### Building
+
+```bash
+uv build
+```
+
+## License
+
+Apache License 2.0

{hanzo-0.3.23 → hanzo-0.3.24}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hanzo"
-version = "0.3.23"
+version = "0.3.24"
 description = "Hanzo AI - Complete AI Infrastructure Platform with CLI, Router, MCP, and Agent Runtime"
 authors = [
     {name = "Hanzo AI", email = "dev@hanzo.ai"},

{hanzo-0.3.23 → hanzo-0.3.24}/src/hanzo/base_agent.py

@@ -10,13 +10,12 @@ import os
 import asyncio
 import logging
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Protocol, TypeVar, Generic
-from dataclasses import dataclass, field
-from datetime import datetime
+from typing import Any, Dict, List, Generic, TypeVar, Optional, Protocol
 from pathlib import Path
+from datetime import datetime
+from dataclasses import field, dataclass
 
-from .model_registry import registry, ModelConfig
-
+from .model_registry import ModelConfig, registry
 
 logger = logging.getLogger(__name__)
 

{hanzo-0.3.23 → hanzo-0.3.24}/src/hanzo/batch_orchestrator.py

@@ -5,28 +5,28 @@ consensus mechanisms, and critic chains using the unified base classes.
 """
 
 import re
+import json
 import asyncio
 import logging
-from typing import Any, Dict, List, Optional, AsyncIterator, Callable
-from dataclasses import dataclass, field
-from datetime import datetime
-from pathlib import Path
-import json
 import subprocess
+from typing import Any, Dict, List, Callable, Optional, AsyncIterator
+from pathlib import Path
+from datetime import datetime
+from dataclasses import field, dataclass
 
-from rich.console import Console
-from rich.progress import Progress, TaskID, TextColumn, SpinnerColumn, BarColumn
-from rich.table import Table
 from rich.panel import Panel
+from rich.table import Table
+from rich.console import Console
+from rich.progress import TaskID, Progress, BarColumn, TextColumn, SpinnerColumn
 
 try:
     # Try to import from hanzo-mcp if available
-    from hanzo_mcp.core.model_registry import registry
     from hanzo_mcp.core.base_agent import AgentConfig, AgentResult, AgentOrchestrator
+    from hanzo_mcp.core.model_registry import registry
 except ImportError:
     # Fall back to local imports if hanzo-mcp is not installed
-    from .model_registry import registry
     from .base_agent import AgentConfig, AgentResult, AgentOrchestrator
+    from .model_registry import registry
 
 logger = logging.getLogger(__name__)
 console = Console()
@@ -906,7 +906,7 @@ class MetaAIOrchestrator:
             )
             try:
                 return json.loads(result)
-            except:
+            except Exception:
                 pass
         
         # Fallback intent detection

{hanzo-0.3.23 → hanzo-0.3.24}/src/hanzo/cli.py

@@ -14,12 +14,13 @@ from .commands import (
     mcp,
     auth,
     chat,
+    node,
     repl,
     agent,
     miner,
     tools,
     config,
-    cluster,
+    router,
     network,
 )
 from .utils.output import console
@@ -72,7 +73,7 @@ def cli(ctx, verbose: bool, json: bool, config: Optional[str]):
 # Register command groups
 cli.add_command(agent.agent_group)
 cli.add_command(auth.auth_group)
-cli.add_command(cluster.cluster_group)
+cli.add_command(node.cluster)
 cli.add_command(mcp.mcp_group)
 cli.add_command(miner.miner_group)
 cli.add_command(chat.chat_command)
@@ -80,6 +81,7 @@ cli.add_command(repl.repl_group)
 cli.add_command(tools.tools_group)
 cli.add_command(network.network_group)
 cli.add_command(config.config_group)
+cli.add_command(router.router_group)
 
 
 # Quick aliases
@@ -95,12 +97,12 @@ def ask(ctx, prompt: tuple, model: str, local: bool):
 
 
 @cli.command()
-@click.option("--name", "-n", default="hanzo-local", help="Cluster name")
+@click.option("--name", "-n", default="hanzo-local", help="Node name")
 @click.option("--port", "-p", default=8000, help="API port")
 @click.pass_context
 def serve(ctx, name: str, port: int):
-    """Start local AI cluster (alias for 'hanzo cluster start')."""
-    asyncio.run(cluster.start_cluster(ctx, name, port))
+    """Start local AI node (alias for 'hanzo node start')."""
+    asyncio.run(node.start_node(ctx, name, port))
 
 
 @cli.command()