forge-kaif 0.3.0

A modular Python infrastructure runtime for config, logging, retries, AI, and more

forge

The developer runtime for AI-era Python.

---

Stop rebuilding your infrastructure. Start shipping.

forge is a modular Python runtime that eliminates the undifferentiated heavy lifting of backend development — config, logging, retries, AI model integration, health checks, caching, and more — so you can focus on building what makes your product unique.

from forge.ai import complete, Message

response = await complete(
    messages=[Message.user("What is 2+2?")],
    model="gpt-4o",
)
print(response.content)

What is forge?

forge is not a web framework. It is the infrastructure layer that sits below your web framework — the reusable runtime that every Python backend service needs.

• Config — typed, validated, layered configuration from env vars, .env, and TOML
• Logging — structured JSON logging with automatic trace context propagation
• Retry — exponential backoff, jitter, circuit breaker, and timeout management
• AI — unified interface across OpenAI, Anthropic, Gemini, and Ollama
• Health — Kubernetes-compatible /health and /ready endpoints
• Cache — decorator-based caching with in-memory and Redis backends
• Validation — Pydantic-integrated input validation with consistent error responses
• CLI — forge init, forge check config, forge add module

Quick Start

pip install forge-kaif

import asyncio
from forge.ai import complete, Message

async def main():
    response = await complete(
        messages=[Message.user("Hello, world")],
    )
    print(response.content)

asyncio.run(main())

Documentation

Full documentation is available at useforge.dev/docs.

Contributing

We welcome contributions! See CONTRIBUTING.md to get started.

License

MIT — see LICENSE for details.