celeste-ai 0.0.3

Open source, type-safe primitives for multi-modal AI. All capabilities, all providers, one interface

Celeste AI

The primitive layer for multi-modal AI

All capabilities. All providers. One interface.

Primitives, not frameworks.

Quick Start • Request Provider

---

🚀 Quick Start

from celeste import create_client, Capability, Provider

# Create client
client = create_client(
    capability=Capability.TEXT_GENERATION,
    provider=Provider.ANTHROPIC,
    api_key="your-api-key",  # Or loads automatically from environment
)

# Generate
response = await client.generate(prompt="Explain quantum computing")
print(response.content)

Install:

uv add "celeste-ai[text-generation]"  # Text only
uv add "celeste-ai[image-generation]" # Image generation
uv add "celeste-ai[all]"              # Everything

---

🎨 Multi-Modal Example

# Same API, different modalities
text_client = create_client(Capability.TEXT_GENERATION, Provider.ANTHROPIC)
image_client = create_client(Capability.IMAGE_GENERATION, Provider.OPENAI)
video_client = create_client(Capability.VIDEO_GENERATION, Provider.GOOGLE)

text = await text_client.generate(prompt="Write a haiku about AI")
image = await image_client.generate(prompt="A sunset over mountains")
video = await video_client.generate(prompt="Waves crashing on a beach")

No special cases. No separate libraries. One consistent interface.

---

and many more

Missing a provider? Request it – ⚡ we ship fast.

---

🔧 Type-Safe by Design

# Full IDE autocomplete
response = await client.generate(
    prompt="Explain AI",
    temperature=0.7,    # ✅ Validated (0.0-2.0)
    max_tokens=100,     # ✅ Validated (int)
)

# Typed response
print(response.content)              # str (IDE knows the type)
print(response.usage.input_tokens)   # int
print(response.metadata["model"])     # str

Catch errors before production.

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md.

Request a provider: GitHub Issues Report bugs: GitHub Issues

---

📄 License

Apache 2.0 license – see LICENSE for details.

---

Get Started • Documentation • GitHub

Made with ❤️ by developers tired of framework lock-in