hicharlie 0.1.0

HiCharlie conversational Python SDK (REST + realtime audio websocket).

HiCharlie Python SDK

Client-side Python SDK for HiCharlie conversational voice sessions.

Install

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

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()