Metadata-Version: 2.4
Name: kiss-agent-sdk
Version: 0.0.19
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: pytest>=8 ; extra == 'test'
Requires-Dist: pytest-asyncio>=0.24 ; extra == 'test'
Provides-Extra: test
Summary: Embed the kiss coding agent in a Python program
Keywords: agent,coding-agent,llm,sdk
Author: kiss contributors
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Repository, https://github.com/racetozero/kiss

# kiss-sdk for Python

Python 3.11+ bindings for the KISS coding agent. The native module uses PyO3's
stable `abi3-py311` ABI, so one wheel works on Python 3.11 and newer.

```python
import asyncio
from kiss_sdk import Session


async def main() -> None:
    async with await Session.create(tools=['read', 'bash']) as session:
        events = session.events()
        session.prompt_detached('List the files here')
        async for event in events:
            if event.type == 'message_update':
                update = event['assistantMessageEvent']
                if update['type'] == 'text_delta':
                    print(update['delta'], end='', flush=True)
            if event.type == 'agent_settled':
                break


asyncio.run(main())
```

Build locally with:

```sh
maturin develop
pytest -q
```

See the repository's `docs/sdk.md` and `docs/rpc.md` for the complete API and
event protocol.

