Quick Start

This guide will help you make your first generation request with Celeste.

Install

Install Celeste:

uv add celeste-ai

Configure Credentials

Set your API keys as environment variables. Celeste will automatically look for them.

export ANTHROPIC_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."

Or create a .env file:

.env

ANTHROPIC_API_KEY=sk-...
OPENAI_API_KEY=sk-...

Use a domain namespace (recommended)

Import celeste and call the domain you work with. Domain is what you work with, not input or output.

import celeste

# Domain: text
response = await celeste.text.generate(
    model="claude-sonnet-4-5",
    prompt="Explain quantum computing in one sentence.",
)
print(response.content)

Generate Content

Non-blocking I/O. Recommended for production apps and notebooks.

response = await celeste.text.generate(
    model="claude-sonnet-4-5",
    prompt="Explain quantum computing in one sentence.",
    temperature=0.7,
)
print(response.content)

Blocking I/O. Suitable for scripts and simple tools.

response = celeste.text.sync.generate(
    model="claude-sonnet-4-5",
    prompt="Explain quantum computing in one sentence.",
    temperature=0.7,
)
print(response.content)

Celeste uses the same interface for every domain and operation.

import celeste

# Text domain → text output
text = await celeste.text.generate(
    model="claude-sonnet-4-5",
    prompt="Write a haiku about AI",
)

# Images domain → image output
image = await celeste.images.generate(
    model="gpt-image-1",
    prompt="A futuristic city at sunset",
)

# Videos domain → video output
video = await celeste.videos.generate(
    model="veo-3",
    prompt="Waves crashing on a beach",
)

Quick Start

Quick Start

Install

Configure Credentials

Use a domain namespace (recommended)

Generate Content

Multi-Modal Example

On this page