Keiro

Python client and command-line interface for the Keiro eb1 API.

Install

Keiro requires Python 3.11 or later.

python -m pip install keiro

Quickstart

Configure your API credentials:

keiro setup

Then send a prompt:

from keiro import models

answer = models("eb1-preview", "What is machine learning?")
print(answer)

Models

Prompt-first API

The models facade returns text directly for the common case:

from keiro import models

answer = models("eb1-preview", "Explain dependency injection with a short example.")
print(answer)

Use models.response() when you also need response metadata:

from keiro import models

response = models.response("eb1-preview", "Summarize the benefits of type hints.")
print(response.text)
print(response.usage)

Create a reusable binding when several prompts share the same model and parameters:

from keiro import models

concise = models.instance("eb1-fast-preview", max_tokens=200)
print(concise("Explain immutable data."))
print(concise("Explain idempotency."))

Stream text as it arrives:

from keiro import models

for chunk in models.stream("eb1-preview", "Draft a concise project update."):
    print(chunk, end="", flush=True)

Call models.close() when a long-running process is finished with the shared client connection.

CLI usage

Run an interactive session:

keiro

Send a one-shot prompt or select a model:

keiro "Explain semantic versioning."
keiro -m eb1-fast-preview "Summarize this text."

Pipe context from another command:

git diff | keiro "Review this change for correctness."

List the models available to your account or open the browser client:

keiro models
keiro gui

Run keiro --help for the complete command reference.

Configuration

keiro setup validates your API key and saves the client configuration under ~/.keiro/. Run it again whenever you need to replace your credentials.

For programmatic configuration, pass credentials directly to Client:

from keiro import Client

with Client(
    api_key="your-api-key",
    base_url="https://api.keirolabs.ai/v1",
) as client:
    response = client.chat(
        messages=[{"role": "user", "content": "Explain binary search."}],
        model="eb1-preview",
    )
    print(response["choices"][0]["message"]["content"])

Explicit Client arguments take precedence over saved configuration.

Requirements

• Python 3.11, 3.12, or 3.13
• A Keiro API key
• Network access to the Keiro API