Metadata-Version: 2.4
Name: donkeyai
Version: 0.1.0
Summary: Unleash smart AI applications.
Project-URL: Documentation, https://donkey-project.github.io/donkey
Project-URL: Repository, https://github.com/donkey-project/donkey
Author-email: Leonardo Furnielis <leonardofurnielis@outlook.com>
License: Apache-2.0
License-File: LICENSE
Keywords: AI,LLM,QA,RAG,data,observability,retrieval,semantic-search
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.14,>=3.11
Requires-Dist: donkey-core<0.2.0,>=0.1.0
Requires-Dist: donkey-llms-litellm<0.2.0,>=0.1.0
Requires-Dist: donkey-loaders-file<0.2.0,>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio<2.0.0,>=1.4.0; extra == 'dev'
Requires-Dist: pytest-mock<4.0.0,>=3.15.1; extra == 'dev'
Requires-Dist: pytest<10.0.0,>=9.1.1; extra == 'dev'
Requires-Dist: ruff<0.16.0,>=0.15.20; extra == 'dev'
Description-Content-Type: text/markdown

<div align="center">
  <p><strong>Build production-ready AI applications with modular, composable components.</strong></p>
</div>

<p align="center">
  <a href="https://github.com/donkey-project/donkey/actions/workflows/test.yml"><img src="https://github.com/donkey-project/donkey/actions/workflows/test.yml/badge.svg" alt="CI"></a>
  <a href="https://pypi.org/project/donkeyai/"><img src="https://img.shields.io/pypi/v/donkeyai?style=flat&colorA=black&colorB=black" alt="PyPI"></a>
  <a href="https://pepy.tech/projects/donkeyai"><img src="https://static.pepy.tech/personalized-badge/donkeyai?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=BLACK" alt="Downloads"></a>
  <a href="LICENSE"><img src="https://img.shields.io/pypi/l/donkeyai?style=flat&colorA=black&colorB=black" alt="License"></a>
  <a href="https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
</p>

<p align="center">
  <a href="https://donkey-project.github.io/donkey"><strong>Documentation</strong></a> ·
  <a href="https://github.com/donkey-project/donkey/issues/new?template=bug-report.yml"><strong>Report Bug</strong></a> ·
  <a href="https://github.com/donkey-project/donkey/issues/new?template=feature-request.yml"><strong>Request Feature</strong></a>
</p>

## Key Features

- 🏗️ **Modular Architecture** — Pick only the components you need. Each integration is its own installable package.
- ⚡ **Async-First Workflows** — Event-driven workflow engine with fan-out/fan-in, shared state, and built-in HTTP server.
- 🔌 **Enterprise Integrations** — First-class support for watsonx.ai, Elasticsearch, Chroma, Hugging Face, and more.
- 📊 **Built-in Observability** — Instrument your pipelines with OpenTelemetry-compatible tracing and custom metrics.
- 🛡️ **Guardrails** — Apply input/output guardrails to keep your AI applications safe and compliant.
- 📄 **Document Pipelines** — Load, chunk, embed, and store documents with prebuilt ingestion workflows.


## Installation

```bash
pip install donkeyai
```

With [uv](https://docs.astral.sh/uv/):

```bash
uv add donkeyai
```

## Contributing

We welcome contributions! Please see our [issue templates](https://github.com/donkey-project/donkey/issues/new/choose) to get started.

## License

[Apache License 2.0](LICENSE).
