Metadata-Version: 2.5
Name: ankka
Version: 0.5.0
Summary: The ankka SDK for Python: components in Python, hosted by the ankka sidecar
Project-URL: Homepage, https://docs.ankka.cloud/
Project-URL: Documentation, https://docs.ankka.cloud/reference/python-sdk/
Project-URL: Repository, https://github.com/thinkmorestupidless/ankka
Project-URL: Changelog, https://github.com/thinkmorestupidless/ankka/releases
Author: Trevor Burton-McCreadie
License-Expression: Apache-2.0
Keywords: agents,ankka,event-sourcing,pekko,serverless,workflows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: grpcio<2,>=1.84
Requires-Dist: protobuf<8,>=6
Provides-Extra: testkit
Requires-Dist: httpx>=0.27; extra == 'testkit'
Requires-Dist: testcontainers<5,>=4.15; extra == 'testkit'
Description-Content-Type: text/markdown

# ankka for Python

Components in Python — event sourced and key value entities, views, consumers, workflows, timed actions,
agents and HTTP endpoints — hosted by the ankka sidecar, the same runtime that hosts a Scala service.
Your process decides what should happen; the sidecar owns sharding, the journal, projections, timers,
HTTP, the agent loop and the model key.

- [Your first service in Python](https://docs.ankka.cloud/get-started/first-service-python/)
- [Services in other languages](https://docs.ankka.cloud/concepts/polyglot/) — how the sidecar model works
- [Python SDK reference](https://docs.ankka.cloud/reference/python-sdk/) — the API, and developing this SDK
- [Sidecar protocol](https://docs.ankka.cloud/reference/sidecar-protocol/)

The same pages are in this repository under
[`docs/`](https://github.com/thinkmorestupidless/ankka/tree/main/docs).

```bash
uv add "ankka==<the version of the platform you deploy to>"   # from PyPI, published with every release
```

Developing the SDK itself, from this directory:

```bash
uv sync && uv run python scripts/proto.py && uv run pytest -q && uv run mypy && uv run conformance
```
