Metadata-Version: 2.4
Name: hanzo
Version: 0.3.7
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.8
Classifier: Programming Language :: Python :: 3.9
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.8
Requires-Dist: click>=8.1.0
Requires-Dist: hanzo-net>=0.1.12
Requires-Dist: httpx>=0.23.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.2; 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.2; 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 AI - Complete AI Infrastructure Platform

The main SDK for the Hanzo AI ecosystem, providing unified access to all Hanzo tools and services.

## Installation

```bash
# Install base package with CLI
pip install hanzo

# Install with all components
pip install hanzo[all]

# Install specific components
pip install hanzo[ai]      # AI SDK (same as standalone hanzoai package)
pip install hanzo[router]  # LLM gateway router (replaces litellm)
pip install hanzo[mcp]     # Model Context Protocol server
pip install hanzo[agents]  # Agent runtime and orchestration
pip install hanzo[repl]    # Interactive REPL with AI chat
```

## Features

- **Unified LLM Gateway**: Use `hanzo.router` instead of litellm for 100+ LLM providers
- **MCP Integration**: Full Model Context Protocol support for AI tools
- **Agent Runtime**: Build and deploy AI agents with the agent framework
- **Interactive REPL**: Chat with AI models directly from the command line
- **Complete SDK**: Import all Hanzo components from a single package

## Quick Start

### Command Line
```bash
# Main CLI
hanzo --help

# Start MCP server
hanzo-mcp

# Interactive AI chat
hanzo-ai
hanzo-chat

# REPL interface
hanzo-repl
```

### Python SDK
```python
import hanzo

# Use router for LLM calls (replaces litellm)
from hanzo import router
response = router.completion(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

# Use agents
from hanzo import Agent, Network
agent = Agent(name="assistant")

# Use MCP tools
from hanzo import Tool, MCPServer

# Access AI SDK
from hanzo import Client
client = Client(api_key="...")
```

## Components

- **hanzo.router**: Unified LLM gateway (replaces litellm)
- **hanzo.mcp**: Model Context Protocol server and tools
- **hanzo.agents**: Agent runtime and orchestration
- **hanzo.memory**: Memory systems for agents
- **hanzo.Client**: Main AI SDK client

## Documentation

- [Hanzo AI Docs](https://docs.hanzo.ai)
- [Router Documentation](https://docs.hanzo.ai/router)
- [MCP Documentation](https://docs.hanzo.ai/mcp)
- [Agent Documentation](https://docs.hanzo.ai/agents)