Files
python-sdk/pkg/hanzo/README.md
T
zeekay d772f862dd feat: clean up and consolidate Python SDK packages
- Merged hanzo-cli into main hanzo package (v0.2.4)
- Removed hanzo-mcp-client (using official MCP client)
- Removed empty packages (hanzo-a2a, hanzo-cluster, hanzo-miner, hanzo-tools)
- Added hanzo and hanzo-repl to CI pipeline
- Updated all packages with parallel testing (pytest-xdist)
- Consolidated from 15 to 8 active packages
- Fixed imports and dependencies after consolidation
- All CI tests passing with 111 total tests across 5 packages
2025-08-06 17:05:48 -05:00

2.1 KiB

Hanzo AI - Complete AI Infrastructure Platform

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

Installation

# 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

# Main CLI
hanzo --help

# Start MCP server
hanzo-mcp

# Interactive AI chat
hanzo-ai
hanzo-chat

# REPL interface
hanzo-repl

Python SDK

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