Metadata-Version: 2.4
Name: praisonaiagents
Version: 1.8.0
Summary: Open-source Python AI agent framework that runs on your own computers, even fully offline.
Author: Mervin Praison
License: MIT
Project-URL: Homepage, https://docs.praison.ai
Project-URL: Documentation, https://docs.praison.ai
Project-URL: Repository, https://github.com/MervinPraison/PraisonAI
Project-URL: Issues, https://github.com/MervinPraison/PraisonAI/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.10.0
Requires-Dist: rich
Requires-Dist: openai>=1.68.2
Requires-Dist: posthog>=3.0.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: tzdata; sys_platform == "win32"
Requires-Dist: tomli>=1.1.0; python_version < "3.11"
Requires-Dist: croniter>=6.0
Provides-Extra: sandbox
Requires-Dist: praisonai-sandbox>=0.0.13; extra == "sandbox"
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.20.0; extra == "mcp"
Requires-Dist: fastapi>=0.115.0; extra == "mcp"
Requires-Dist: uvicorn>=0.34.0; extra == "mcp"
Requires-Dist: websockets>=12.0; extra == "mcp"
Provides-Extra: parallel-search
Requires-Dist: mcp<2,>=1.30.0; extra == "parallel-search"
Provides-Extra: memory
Requires-Dist: chromadb>=1.0.0; extra == "memory"
Requires-Dist: litellm<1.106,>=1.83.14; extra == "memory"
Provides-Extra: knowledge
Requires-Dist: mem0ai>=0.1.0; extra == "knowledge"
Requires-Dist: chromadb>=1.0.0; extra == "knowledge"
Requires-Dist: markitdown[all]>=0.1.0; extra == "knowledge"
Requires-Dist: pandas>=2.2; extra == "knowledge"
Requires-Dist: chonkie>=1.0.2; extra == "knowledge"
Provides-Extra: graph
Requires-Dist: mem0ai[graph]>=0.1.0; extra == "graph"
Requires-Dist: chromadb>=1.0.0; extra == "graph"
Provides-Extra: llm
Requires-Dist: litellm<1.106,>=1.83.14; extra == "llm"
Requires-Dist: pydantic>=2.10.0; extra == "llm"
Provides-Extra: decisions
Requires-Dist: typesafe-sdk>=0.7.0; extra == "decisions"
Provides-Extra: api
Requires-Dist: fastapi>=0.115.0; extra == "api"
Requires-Dist: uvicorn>=0.34.0; extra == "api"
Provides-Extra: os
Requires-Dist: fastapi>=0.115.0; extra == "os"
Requires-Dist: uvicorn>=0.34.0; extra == "os"
Requires-Dist: PyJWT>=2.8.0; extra == "os"
Provides-Extra: telemetry
Requires-Dist: posthog>=3.0.0; extra == "telemetry"
Provides-Extra: mongodb
Requires-Dist: pymongo>=4.6.3; extra == "mongodb"
Requires-Dist: motor>=3.4.0; extra == "mongodb"
Provides-Extra: dakera
Requires-Dist: dakera>=0.12.8; extra == "dakera"
Provides-Extra: auth
Requires-Dist: PyJWT>=2.8.0; extra == "auth"
Requires-Dist: passlib[bcrypt]>=1.7.4; extra == "auth"
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "auth"
Requires-Dist: python-multipart>=0.0.6; extra == "auth"
Provides-Extra: autonomy
Requires-Dist: ast-grep-cli>=0.30.0; extra == "autonomy"
Provides-Extra: search
Requires-Dist: ddgs>=9.0.0; extra == "search"
Provides-Extra: crawl
Requires-Dist: crawl4ai>=0.4.0; extra == "crawl"
Requires-Dist: playwright>=1.47.0; extra == "crawl"
Provides-Extra: a2ui
Requires-Dist: a2ui-agent-sdk>=0.2.1; extra == "a2ui"
Requires-Dist: a2a-sdk<1.0.0,>=0.3.0; extra == "a2ui"
Provides-Extra: all
Requires-Dist: praisonaiagents[memory]; extra == "all"
Requires-Dist: praisonaiagents[sandbox]; extra == "all"
Requires-Dist: praisonaiagents[knowledge]; extra == "all"
Requires-Dist: praisonaiagents[graph]; extra == "all"
Requires-Dist: praisonaiagents[llm]; extra == "all"
Requires-Dist: praisonaiagents[decisions]; extra == "all"
Requires-Dist: praisonaiagents[mcp]; extra == "all"
Requires-Dist: praisonaiagents[api]; extra == "all"
Requires-Dist: praisonaiagents[telemetry]; extra == "all"
Requires-Dist: praisonaiagents[mongodb]; extra == "all"
Requires-Dist: praisonaiagents[auth]; extra == "all"
Requires-Dist: praisonaiagents[search]; extra == "all"
Requires-Dist: praisonaiagents[crawl]; extra == "all"
Requires-Dist: praisonaiagents[autonomy]; extra == "all"
Requires-Dist: praisonaiagents[os]; extra == "all"
Requires-Dist: praisonaiagents[a2ui]; extra == "all"
Dynamic: license-file

# praisonaiagents

The lightweight core of [PraisonAI](https://github.com/MervinPraison/PraisonAI): a Python SDK for AI agents, tools, memory and multi-agent workflows. Importing it loads no LLM library; dependencies load only when a feature needs them.

```bash
pip install praisonaiagents
export OPENAI_API_KEY="your-api-key"   # or use a local model, below
```

## An agent in three lines

```python
from praisonaiagents import Agent

agent = Agent(instructions="You are a helpful assistant")
print(agent.start("Write a haiku about the sea"))
```

## Give it a tool

Any typed Python function with a docstring is a tool.

```python
from praisonaiagents import Agent

def get_weather(city: str) -> str:
    """Return the current weather for a city."""
    return f"It is sunny and 22°C in {city}."

agent = Agent(instructions="Answer weather questions", tools=[get_weather])
print(agent.start("What's the weather in Paris?"))
```

## Other models

Pass `model=`, for example `model="gpt-4o-mini"`, `model="anthropic/claude-sonnet-4-5"` or a local `model="ollama/llama3.2"` (no API key). `provider/model` names are routed through litellm: `pip install "praisonaiagents[llm]"`.

## Learn more

- [Documentation](https://praison.ai/docs): [Agents](https://praison.ai/docs/concepts/agents) · [Tools](https://praison.ai/docs/tools/tools) · [Memory](https://praison.ai/docs/concepts/memory) · [Workflows](https://praison.ai/docs/concepts/agentflow)
- `pip install praisonai` adds the terminal CLI, YAML agents, bots and the UI on top of this package.
- [Source and issues](https://github.com/MervinPraison/PraisonAI) · MIT licence
