Zumik
Examples

Examples

Runnable reference integrations against a live Zumik deployment - OpenAI migration, a coding agent, RAG over sessions, and a multi-turn agent runtime.

Each example is a self-contained, runnable reference integration with its own README and pinned dependencies. They read the API key from ZUMIK_API_KEY and never hardcode it. The source lives in examples/ in the repository.

export ZUMIK_API_KEY="zk_..."
# optional, for staging / self-hosted:
# export ZUMIK_BASE_URL="https://api.zumik.ai/v1"      # OpenAI-compatible surface
# export ZUMIK_BASE_URL_V2="https://api.zumik.ai"      # native /v2 surface root

What they share

The three native examples (coding agent, RAG, agent runtime) all follow the same reuse pattern: upload stable content as immutable artifacts, assemble it into an agent_prefix bundle, pin the bundle to a session, then run turns against the session so the compiled prefix is reused instead of resent. The reuse is reported on the response, never guessed - see reuse metrics.

They talk to the API with httpx (native /v2) and the official openai client (compatible /v1 stream) directly, so they have no dependency on an unpublished SDK. If you prefer the first-party SDK, install the Python SDK - it calls the same endpoints. The examples are intentionally outside the pnpm and Cargo workspace so they stand alone.

Before you run

You need an API key and a prepaid credit balance; inference is blocked until your balance is funded. See the quickstart and authentication.

On this page