Metadata-Version: 2.4
Name: symbolica-agentica
Version: 0.3.0rc0
Summary: Agentica Python SDK
Project-URL: Homepage, https://www.symbolica.ai/agentica
Project-URL: Issues, https://github.com/symbolica-ai/agentica-issues
Classifier: Programming Language :: Python :: 3
Requires-Python: <3.14.0,>=3.12.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.12.15
Requires-Dist: trio>=0.31.0
Requires-Dist: platformdirs>=4.5.0
Requires-Dist: opentelemetry-instrumentation-httpx>=0.41b0
Requires-Dist: opentelemetry-api>=1.20.0
Requires-Dist: typing-extensions>=4.15.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: rich>=14.2.0
Requires-Dist: opentelemetry-sdk>=1.20.0
Requires-Dist: rich>=14.1.0
Requires-Dist: xxhash>=3.5.0
Requires-Dist: fastmcp<=2.12.3
Requires-Dist: websockets>=15.0.1
Requires-Dist: msgspec>=0.19.0
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20.0
Requires-Dist: dotenv>=0.9.9
Requires-Dist: prompt-toolkit>=3.0.52
Dynamic: license-file

# Agentica Python SDK

[![PyPI version](https://img.shields.io/pypi/v/symbolica-agentica.svg)](https://pypi.org/project/symbolica-agentica/)

[Agentica](https://agentica.symbolica.ai) is a type-safe AI framework that lets LLM agents integrate with your code—functions, classes, live objects, even entire SDKs. Instead of building MCP wrappers or brittle schemas, you pass references directly; the framework enforces your types at runtime, constrains return types, and manages agent lifecycle.

## Documentation

The full documentation can be found at [docs.symbolica.ai](https://docs.symbolica.ai).

## Installation

```sh
pip install symbolica-agentica
```

## Quick Example

```python
from agentica import agentic
from typing import Literal

@agentic()
async def analyze(text: str) -> Literal["positive", "neutral", "negative"]:
    """Analyze sentiment"""
    ...

result = await analyze("Type-constrained generation, in your codebase, is the future.")
```

See the [Quickstart Guide](https://docs.symbolica.ai/quickstart) for a complete walkthrough.

## Requirements

Python 3.12 or 3.13, `uv`.

## Issues

Please report bugs, feature requests, and other issues in the [symbolica/agentica-issues](https://github.com/symbolica-ai/agentica-issues) repository.

## Contributing

See [CONTRIBUTING.md](https://github.com/symbolica-ai/agentica-python-sdk/blob/main/CONTRIBUTING.md) for guidelines. All contributors must agree to our [CLA](https://github.com/symbolica-ai/agentica-python-sdk/blob/main/CLA.md).

## Code of Conduct

This project adheres to a [Code of Conduct](https://github.com/symbolica-ai/agentica-python-sdk/blob/main/CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.

## License

See [LICENSE](https://github.com/symbolica-ai/agentica-python-sdk/blob/main/LICENSE).

