Python SDK

Python client with fluent API

Installation

bash

pip install echostash

Initialization

python

from echostash import Echostash

es = Echostash("https://api.echostash.app",
    api_key=os.environ["ECHOSTASH_API_KEY"])

Fetch and Convert

python

# Fetch → convert to Anthropic format
result = (
    es.prompt("support-agent")
    .version("published")
    .with_vars({"customer_name": "Alice", "tier": "premium"})
    .anthropic()
)

# Use with Anthropic SDK
response = client.messages.create(
    system=result.get("system"),
    messages=result["messages"],
    tools=result.get("tools"),
    model=result.get("model", "claude-sonnet-4-5-20250929"),
)

Server-Side Render

python

rendered = es.prompt("greeting").render({"name": "Alice"})
print(rendered.content)

Batch Render

python

batch = es.batch_render([
    {"prompt_id": 1, "variables": {"name": "Alice"}},
    {"prompt_id": 2, "variables": {"name": "Bob"}},
])