Metadata-Version: 2.4
Name: hicharlie
Version: 0.1.0
Summary: HiCharlie conversational Python SDK (REST + realtime audio websocket).
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: pyaudio>=0.2.14
Requires-Dist: pydantic>=2.0.0
Requires-Dist: websockets>=13.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# HiCharlie Python SDK

Client-side Python SDK for HiCharlie conversational voice sessions.

## Install

```bash
pip install hicharlie
```

## Features

- REST client:
  - `list_agents()`
  - `get_agent(agent_id)`
  - `create_session(...)`
  - `get_transcript(session_id)`
- Realtime conversation lifecycle over WebSocket (`Conversation`)
- Default PyAudio input/output with active default-device hot-swap

## Quickstart

```python
from hicharlie import Conversation, DefaultAudioInterface, HiCharlie

client = HiCharlie(api_key="hc_xxx", base_url="https://voice.hicharlie.fr")
session = client.create_session(
    system_prompt="Tu es un assistant technique.",
    first_message="Salut ! De quoi as-tu besoin ?",
    language="fr",
)

audio = DefaultAudioInterface()
conversation = Conversation(
    session=session,
    audio_interface=audio,
    callback_agent_response=lambda text: print(f"Agent: {text}"),
    callback_user_transcript=lambda text: print(f"User: {text}"),
)

conversation.start_session()
conversation.wait_for_session_end()

transcript = client.get_transcript(session.session_id)
print(transcript)
client.close()
```
