Metadata-Version: 2.4
Name: hachazal
Version: 0.1.0
Summary: Leviathan - AI Orchestration Platform with swarm intelligence
Project-URL: Homepage, https://github.com/leviathan/leviathan
Project-URL: Repository, https://github.com/leviathan/leviathan
Project-URL: Issues, https://github.com/leviathan/leviathan/issues
Author-email: Leviathan Team <team@leviathan.ai>
License: Proprietary
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
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
Requires-Python: >=3.8
Requires-Dist: click>=8.0.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == 'docs'
Requires-Dist: sphinx>=7.0.0; extra == 'docs'
Description-Content-Type: text/markdown

# 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

```bash
pip install leviathan
```

## Quick Start

```python
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:

```env
# 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

```bash
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.