Metadata-Version: 2.4
Name: sumbai
Version: 1.0.1
Summary: AI Engine Framework — engine, SDK facade, and CLI
Author: AI Engine Team
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: browserforge>=1.2.0
Requires-Dist: camoufox[geoip]>=0.4.0
Requires-Dist: dependency-injector>=4.41.0
Requires-Dist: duckduckgo-search>=7.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: inquirerpy>=0.3.0
Requires-Dist: nodriver>=0.50.0
Requires-Dist: playwright>=1.45.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-json-logger>=2.0.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: structlog>=23.0.0
Requires-Dist: typer>=0.9.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pypdf>=4.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: docx
Requires-Dist: python-docx>=1.0.0; extra == 'docx'
Provides-Extra: embeddings
Requires-Dist: sentence-transformers>=2.2.0; extra == 'embeddings'
Provides-Extra: interactive
Requires-Dist: inquirerpy>=0.3.0; extra == 'interactive'
Provides-Extra: litellm
Requires-Dist: litellm>=1.0.0; extra == 'litellm'
Provides-Extra: otel
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.27.0; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.27.0; extra == 'otel'
Provides-Extra: pdf
Requires-Dist: pypdf>=4.0.0; extra == 'pdf'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
Provides-Extra: xlsx
Requires-Dist: openpyxl>=3.1.0; extra == 'xlsx'
Description-Content-Type: text/markdown

# AI Engine Framework

[![CI](https://github.com/ai-engine/framework/actions/workflows/ci.yml/badge.svg)](https://github.com/ai-engine/framework/actions/workflows/ci.yml)
[![PyPI version](https://badge.fury.io/py/ai-engine.svg)](https://pypi.org/project/ai-engine/)
[![Python versions](https://img.shields.io/pypi/pyversions/ai-engine.svg)](https://pypi.org/project/ai-engine/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A modular, extensible framework for building AI-powered applications with Python.

## Features

- **Modular Architecture** - 17 core modules for agents, memory, tools, workflows, and more
- **Plugin System** - Extensible provider plugins for OpenAI, Anthropic, Qdrant, Redis
- **Developer SDK** - Fluent API with async support and type safety
- **CLI Interface** - Interactive chat, project management, and diagnostics
- **Observability** - Built-in tracing, metrics, and audit logging
- **Multi-Agent** - Collaboration, organization, and session management
- **Production Ready** - Comprehensive testing, documentation, and CI/CD

## Installation

```bash
pip install ai-engine
```

With optional plugins:

```bash
pip install "ai-engine[openai,anthropic,qdrant,redis]"
```

## Quick Start

```python
from ai_engine import Engine

async with Engine() as engine:
    result = await engine.run("Hello, world!")
    print(result)
```

## Documentation

- [Getting Started](https://ai-engine.dev/getting-started/)
- [Core Concepts](https://ai-engine.dev/core-concepts/)
- [SDK Reference](https://ai-engine.dev/sdk-reference/)
- [Cookbook](https://ai-engine.dev/cookbook/)
- [Changelog](https://github.com/ai-engine/framework/blob/main/CHANGELOG.md)

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## Security

For security vulnerabilities, please see [SECURITY.md](SECURITY.md).

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
