Metadata-Version: 2.1
Name: honcho-ai
Version: 0.0.2
Summary: Python Client SDK for Honcho
License: AGPL-3.0
Author: Plastic Labs
Author-email: hello@plasticlabs.ai
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: httpx (>=0.26.0,<0.27.0)
Description-Content-Type: text/markdown

# Honcho

A User context management solution for building AI Agents and LLM powered
applications.

Read about the motivation of this project [here](https://blog.plasticlabs.ai).

Read the full documentation of this project [here](https://docs.honcho.dev)

## Installation

Install honcho:

```bash
pip install honcho-ai
```

or 

```bash
poetry add honcho-ai
```

## Getting Started

The Honcho SDK exposes a top level client that contains methods for managing the
lifecycle of different conversations and sessions in an LLM powered application.

There is a demo server being run at https://demo.honcho.dev that the client uses
by default if no other string is provided.

```python
from uuid import uuid4
from honcho import Client as HonchoClient

app_id = str(uuid4())
honcho = HonchoClient(app_id=app_id)
user_id = "test"
session = honcho.create_session(user_id=user_id)


session.create_message(is_user=True, content="Hello I'm a human")
session.create_message(is_user=False, content="Hello I'm an AI")
```

The honcho sdk code contains docstrings — see the full sdk on
[GitHub](https://github.com/plastic-labs/honcho/tree/main/sdk/honcho/client.py)

See more examples of how to use the SDK on [GitHub](https://github.com/plastic-labs/honcho/tree/main/example)

