Metadata-Version: 2.4
Name: lionpride
Version: 1.0.0a0
Summary: The kernel layer for production AI agents - protocol-based, type-safe, zero framework lock-in
Project-URL: Homepage, https://github.com/khive-ai/lionpride
Project-URL: Documentation, https://github.com/khive-ai/lionpride/blob/main/README.md
Project-URL: Repository, https://github.com/khive-ai/lionpride
Project-URL: Issues, https://github.com/khive-ai/lionpride/issues
Project-URL: Changelog, https://github.com/khive-ai/lionpride/blob/main/CHANGELOG.md
Author-email: HaiyangLi <quantocean.li@gmail.com>
License: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,async,llm,multi-agent,orchestration,protocols,type-safety
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: anyio>=4.7.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydapter>=1.2.0
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: tiktoken>=0.8.0
Provides-Extra: all
Requires-Dist: datamodel-code-generator>=0.25.0; extra == 'all'
Requires-Dist: fastmcp>=2.13.0; extra == 'all'
Provides-Extra: mcp
Requires-Dist: fastmcp>=2.13.0; extra == 'mcp'
Provides-Extra: schema-gen
Requires-Dist: datamodel-code-generator>=0.25.0; extra == 'schema-gen'
Description-Content-Type: text/markdown

# lionpride

[![PyPI version](https://img.shields.io/pypi/v/lionpride.svg)](https://pypi.org/project/lionpride/)
[![Python](https://img.shields.io/pypi/pyversions/lionpride.svg)](https://pypi.org/project/lionpride/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/khive-ai/lionpride/blob/main/LICENSE)
[![CI](https://github.com/khive-ai/lionpride/actions/workflows/ci.yml/badge.svg)](https://github.com/khive-ai/lionpride/actions/workflows/ci.yml)
[![codecov](https://codecov.io/github/khive-ai/lionpride/graph/badge.svg?token=FAE47FY26T)](https://app.codecov.io/github/khive-ai/lionherd-core)
[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)

**Production-ready multi-agent workflow orchestration framework.**

> **Alpha Release** - API may change. Originated from [lionagi](https://github.com/khive-ai/lionagi) v0, elevated and hardened for production use.

## Features

- **Model Agnostic** - Built-in providers for OpenAI-compatible APIs, Anthropic, Gemini, Claude Code
- **LNDL** - Domain-specific language for LLM structured output and enhanced reasoning (JSON fallback supported)
- **75% Token Reduction** - Efficient instruction representation for complex agentic workflows (e.g., 20+ tools)
- **Async Native** - Operation graph building, dependency-aware execution, auto-extensions
- **Modular Architecture** - Protocol-based composition, zero framework lock-in

## Installation

```bash
pip install lionpride
```

## Quick Start

```python
from lionpride import Session
from lionpride.services import iModel

# Create session with model
session = Session()
model = iModel(provider="openai", model="gpt-4o-mini")
session.register_service(model)

# Create branch and operate
branch = session.create_branch()
result = await branch.operate(
    instruction="Analyze this data",
    imodel=model,
)
```

## Roadmap

- Formal mathematical framework
- Rust core for performance-critical paths

## License

Apache-2.0
