analogaisdk 0.4.0

Minimal Python SDK for AnalogAI completion endpoints

AnalogAI SDK (minimal)

Tiny Python client for the Deepthink OpenAI-compatible chat server (analogai.deepthink.chat). It calls POST {CHAT_BASE_URL}/v1/chat/completions — a stateful endpoint: memory tenancy is keyed by user_id + agent_id (both created server-side on first use), Deepthink memory is retrieved per turn, and messages are ingested in the background.

Install

pip install analogaisdk

Setup

Set environment variables in .env:

• CHAT_BASE_URL (default https://cloud.analogai.net:8010; set to http://localhost:8010 for a local server)
• ANALOGAI_AGENT_ID / ANALOGAI_USER_ID (memory tenant; auto-created)
• ANALOGAI_API_KEY (optional, if your server requires auth)
• ANALOGAI_MODEL (optional; server default is used when omitted)

Usage

from analogaisdk import AnalogAIClient

client = AnalogAIClient(agent_id="my-agent", user_id="my-user")

# Non-streaming (default).
print(client.generate_completion("are humans mortal?"))

# Streaming.
for chunk in client.generate_streaming_completion("are humans mortal?"):
    print(chunk, end="", flush=True)

Working memory

Working memory (a string or list of strings) is appended to the LLM system prompt alongside the Deepthink memory:

client.generate_completion(
    "is Socrates mortal?",
    working_memory=["Socrates is a human"],
)

Explicit messages and model

client.generate_completion(
    messages=[
        {"role": "user", "content": "Say hello"},
    ],
    model="azure:gpt-4o-mini",  # optional, provider-prefixed
    temperature=0.2,
)