alloy-client

A lightweight Python client for the Alloy server.

Install

pip install alloyai-client

For local development:

pip install -e .

Quick start

from alloy_client import AlloyClient

client = AlloyClient("http://127.0.0.1:8000")

# Images
result = client.image(model_id="qwen-image", prompt="a cinematic portrait")
with open("output.png", "wb") as f:
    f.write(result["images"][0])

# Chat (non-streaming)
response = client.chat(
    model="qwen3-medium",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response["message"]["content"])

# Audio (non-streaming)
audio = client.audio(
    model_id="qwen3-tts-base",
    text="Hello from Alloy",
)
print(audio["sample_rate"], len(audio["outputs"]))

Types

The client re-exports minimal Ollama-style types so you can annotate inputs without pulling in the ollama dependency:

from alloy_client import Message, JsonSchemaValue

Notes

• Streaming is supported for /image only.
• /chat and /audio are non-streaming for now.