Metadata-Version: 2.4
Name: polos-sdk
Version: 0.1.15
Summary: Polos SDK for Python - Durable Agent Execution
Project-URL: Homepage, https://github.com/polos-dev/polos
Project-URL: Repository, https://github.com/polos-dev/polos
Project-URL: Documentation, https://docs.polos.dev
Project-URL: Issues, https://github.com/polos-dev/polos/issues
Author: Polos Team
License: Apache-2.0
Keywords: agents,ai,async,durable-execution,llm,orchestration,workflow
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: anyio>=4.0.0
Requires-Dist: fastapi>=0.104.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: opentelemetry-api>=1.20.0
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20.0
Requires-Dist: opentelemetry-sdk>=1.20.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: uvicorn>=0.24.0
Provides-Extra: all
Requires-Dist: anthropic>=0.39.0; extra == 'all'
Requires-Dist: litellm>=1.40.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.39.0; extra == 'anthropic'
Provides-Extra: dev
Requires-Dist: pre-commit>=3.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: fireworks
Requires-Dist: litellm>=1.40.0; extra == 'fireworks'
Provides-Extra: gemini
Requires-Dist: litellm>=1.40.0; extra == 'gemini'
Provides-Extra: groq
Requires-Dist: litellm>=1.40.0; extra == 'groq'
Provides-Extra: litellm
Requires-Dist: litellm>=1.40.0; extra == 'litellm'
Provides-Extra: ollama
Requires-Dist: litellm>=1.40.0; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Provides-Extra: together
Requires-Dist: litellm>=1.40.0; extra == 'together'
Description-Content-Type: text/markdown

# Polos Python SDK

Durable execution engine for Python. Build reliable AI agents and workflows that can survive failures, handle long-running tasks, and coordinate complex processes.

## Features

- 🤖 **AI Agents** - Build LLM-powered agents with tool calling, streaming, and conversation history
- 🔄 **Durable Workflows** - Workflows survive failures and resume from checkpoints
- ⏰ **Long-Running** - Execute workflows that run for hours or days
- 🔗 **Workflow Orchestration** - Chain workflows together and build complex processes
- 🛠️ **Tools** - Define reusable tools that agents can call
- 🐍 **Native Python** - Async/await support, type hints, and Pythonic APIs
- 📊 **Observability** - Built-in tracing, events, and monitoring

## Installation

```bash
pip install polos-sdk
```

Or with UV (recommended):
```bash
uv add polos-sdk
```

### Optional Dependencies

Install provider-specific dependencies for LLM support:

```bash
# OpenAI
pip install polos-sdk[openai]

# Anthropic
pip install polos-sdk[anthropic]

# Google Gemini
pip install polos-sdk[gemini]

# Groq
pip install polos-sdk[groq]

# Fireworks
pip install polos-sdk[fireworks]

# Together AI
pip install polos-sdk[together]

# All providers
pip install polos-sdk[openai,anthropic,gemini,groq,fireworks,together]
```

## Quick Start

Use the quickstart guide at [https://docs.polos.dev](https://docs.polos.dev) to get started in minutes.

## License

Apache-2.0 - see [LICENSE](../../LICENSE) for details.

## Support

- 📖 [Documentation](https://docs.polos.dev)
- 💬 [Discord Community](https://discord.gg/ZAxHKMPwFG)
- 🐛 [Issue Tracker](https://github.com/polos-dev/polos/issues)
- 📧 [Email Support](mailto:support@polos.dev)

---

Built with ❤️ by the Polos team
