hachazal 0.1.0

Leviathan - AI Orchestration Platform with swarm intelligence

Leviathan

AI Orchestration Platform with Swarm Intelligence

Leviathan is a sophisticated AI orchestration platform that coordinates multiple AI agents (swarms) to solve complex tasks through collaborative intelligence.

Features

• Swarm Orchestration: Coordinate 708+ AI agents across 7 specialized angels
• Multi-Provider LLM Support: Groq, Cerebras, Together, OpenRouter, Ollama, and more
• Real-time Trading: Paper and live trading with risk management
• HiveMind Memory: Persistent, shared memory across agents
• Video Generation: AI video pipeline with multiple providers
• Plugin System: Extensible architecture for custom skills

Installation

pip install leviathan

Quick Start

from leviathan import Leviathan

# Initialize the platform
leviathan = Leviathan(api_key="your-api-key")

# Deploy a swarm
result = leviathan.swarm.deploy(
    task="Analyze Solana memecoin trends",
    agents=5
)

# Get results
print(result)

Configuration

Create a .env file with your API keys:

# Required for cloud LLM access
GROQ_API_KEY=your-groq-key
OPENROUTER_API_KEY=your-openrouter-key

# Optional providers
CEREBRAS_API_KEY=your-cerebras-key
TOGETHER_API_KEY=your-together-key
OLLAMA_BASE_URL=http://localhost:11434

# PyPI publishing (for maintainers)
PYPI_API_KEY=pypi-your-api-key

CLI Usage

leviathan swarm "your task" --agents 3
leviathan council "strategic decision"
leviathan balance
leviathan keys list

Architecture

• Master (Da'at): HaChazal - orchestrates all angels
• 7 Angels: Zadkiel, Gavriel, Raphael, Uriel, Michael, Malika, Katan
• 100 Agents per Angel: Specialized sub-agents
• Binary Claws: 2,124 tool/surrogate agents (ZeroClaw, PicoClaw, NanoClaw)

Security

• API keys stored in environment variables, never in code
• .env files excluded from version control
• Secure secrets management recommended for production

License

MIT License - see LICENSE file for details.