Metadata-Version: 2.4
Name: kneo-agent
Version: 1.0.1
Summary: Python SDK for building LLM-powered agents across multiple providers.
Author: Kneo Agent Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/kneo-agent/kneo-agent
Project-URL: Repository, https://github.com/kneo-agent/kneo-agent
Project-URL: Issues, https://github.com/kneo-agent/kneo-agent/issues
Keywords: agent,llm,ai,sdk,openai,langchain,google-adk,workflow
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: google-adk
Requires-Dist: google-adk>=0.1.0; extra == "google-adk"
Provides-Extra: openai
Requires-Dist: openai-agents>=0.2.0; extra == "openai"
Provides-Extra: langchain
Requires-Dist: langchain>=0.2.0; extra == "langchain"
Requires-Dist: langchain-core>=0.2.0; extra == "langchain"
Provides-Extra: all
Requires-Dist: google-adk>=0.1.0; extra == "all"
Requires-Dist: openai-agents>=0.2.0; extra == "all"
Requires-Dist: langchain>=0.2.0; extra == "all"
Requires-Dist: langchain-core>=0.2.0; extra == "all"
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: twine>=5.0; extra == "dev"
Dynamic: license-file

# Kneo Agent

Kneo Agent is a Python SDK for building LLM-powered agents across multiple providers with one consistent API.

It supports:

- bridge-style runtimes where Kneo owns the execution loop
- native runtimes backed by provider SDK behavior
- adapter-style wrappers around existing provider objects
- workflows for orchestrating multi-step or multi-agent runs

## Requirements

- Python 3.12+

## Installation

Install the core package from PyPI:

```bash
pip install kneo-agent
```

Install with optional provider extras when needed:

```bash
pip install "kneo-agent[openai]"
pip install "kneo-agent[langchain]"
pip install "kneo-agent[google-adk]"
pip install "kneo-agent[all]"
```

## Quick Start

```python
import asyncio

from kneo_agent import AgentBuilder
from kneo_agent.patterns import BridgeAgentFactory


runtime = BridgeAgentFactory.for_openai(model="gpt-4o", strategy="react")

agent = (
    AgentBuilder()
    .with_name("Assistant")
    .with_system_prompt("You are a helpful assistant.")
    .use_bridge(runtime)
    .build()
)


async def main() -> None:
    reply = await agent.chat("What is 2 + 2?")
    print(reply)


asyncio.run(main())
```

## Optional Features

- `openai`: OpenAI Agents integration
- `langchain`: LangChain integration
- `google-adk`: Google ADK integration
- `all`: all optional provider integrations

## Package Contents

The published distribution contains the `kneo_agent` package and typed package metadata for downstream users.
