Metadata-Version: 2.4
Name: anva
Version: 0.2.0
Summary: Official Python SDK for Anva — live AI avatars for your product.
Project-URL: Homepage, https://anva.ai
Project-URL: Documentation, https://anva.ai/docs
Project-URL: Source, https://github.com/Anva-avatars/anva-sdk
Author-email: Anva <anva.ai.2026@gmail.com>
License: MIT
Keywords: ai,anva,avatar,voice,webrtc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Provides-Extra: ws
Requires-Dist: websockets>=12; extra == 'ws'
Description-Content-Type: text/markdown

# anva — Python SDK

Official Python SDK for [Anva](https://anva.ai) — live AI avatars.

```bash
pip install anva          # REST client, zero dependencies
pip install "anva[ws]"    # + live event stream (WebSocket)
```

```python
from anva import Anva

client = Anva("anva_key_...")

session = client.create_session(character_id="char_...")
print(session["embed_url"])

client.send_message(session["session_id"], "Welcome!")
client.interrupt(session["session_id"])

for event in client.events(session["session_id"]):
    print(event)

chars = client.list_characters()
```

Errors raise `anva.AnvaError` with `.status`, `.code` and `.message`.
MIT © Penguin Robotics
