Metadata-Version: 2.4
Name: praisonai-frameworks
Version: 0.1.2
Summary: Optional agent framework adapters for PraisonAI (CrewAI, AutoGen, extensions)
Project-URL: Homepage, https://praison.ai/docs
Project-URL: Repository, https://github.com/MervinPraison/PraisonAI-Frameworks
Project-URL: Documentation, https://praison.ai/docs/frameworks
Project-URL: Issues, https://github.com/MervinPraison/PraisonAI-Frameworks/issues
Author: Mervin Praison
License: MIT
License-File: LICENSE
Keywords: agents,ai,autogen,crewai,framework,praisonai
Requires-Python: <3.15,>=3.10
Requires-Dist: praisonaiagents>=1.6.82
Provides-Extra: ag2
Requires-Dist: ag2>=0.11.0; extra == 'ag2'
Requires-Dist: praisonai-tools>=0.1.0; extra == 'ag2'
Provides-Extra: all
Requires-Dist: crewai; extra == 'all'
Requires-Dist: crewai>=0.157.0; extra == 'all'
Requires-Dist: praisonai-tools>=0.1.0; extra == 'all'
Requires-Dist: pyautogen==0.2.29; extra == 'all'
Provides-Extra: autogen
Requires-Dist: crewai; extra == 'autogen'
Requires-Dist: praisonai-tools>=0.1.0; extra == 'autogen'
Requires-Dist: pyautogen==0.2.29; extra == 'autogen'
Provides-Extra: autogen-v4
Requires-Dist: autogen-agentchat>=0.4.0; extra == 'autogen-v4'
Requires-Dist: autogen-core>=0.4.0; extra == 'autogen-v4'
Requires-Dist: autogen-ext[openai]>=0.4.0; extra == 'autogen-v4'
Requires-Dist: crewai; extra == 'autogen-v4'
Requires-Dist: praisonai-tools>=0.1.0; extra == 'autogen-v4'
Provides-Extra: crewai
Requires-Dist: crewai>=0.157.0; extra == 'crewai'
Requires-Dist: praisonai-tools>=0.1.0; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# PraisonAI Frameworks

Optional agent framework adapters for [PraisonAI](https://github.com/MervinPraison/PraisonAI).

Implements the `praisonai.framework_adapters` entry-point group so YAML `framework:` values
(`crewai`, `autogen`, …) resolve without bloating the core SDK or wrapper wheel.

## Install

```bash
# Native PraisonAI only (no third-party frameworks)
pip install praisonaiagents praisonai

# CrewAI backend
pip install praisonai-frameworks[crewai]

# AutoGen v0.2 backend
pip install praisonai-frameworks[autogen]
```

## Usage

```yaml
# agents.yaml
framework: crewai
topic: Research AI trends
roles:
  researcher:
    role: Research Analyst
    goal: Find accurate information
    backstory: Expert researcher
    tasks:
      research:
        description: Research {topic}
        expected_output: A concise summary
```

```bash
praisonai run agents.yaml
```

## Architecture

- Depends on **`praisonaiagents` only** (protocol + base helpers in `praisonaiagents.frameworks`)
- Registers adapters via setuptools entry points — no wrapper import required
- Lazy-imports CrewAI / AutoGen inside `run()` only

## Adding a framework

See `examples/third_party_adapter/` and `docs/adding-a-framework.md`.
