litestar-flags¶

Ship features with confidence. Production-ready feature flags for Litestar with percentage rollouts, A/B testing, segment targeting, multi-environment support, analytics, and a complete Admin API.

Get Started GitHub PyPI

Multiple Backends

Memory, Redis, and SQLAlchemy storage backends. Choose what fits your infrastructure.

Percentage Rollouts

Gradually release features to a subset of users. Roll back instantly if issues arise.

A/B Testing

Built-in variant support for experimentation. Measure impact with confidence.

Segment Targeting

Define reusable user segments with complex conditions for powerful targeting rules.

Time-based Rules

Schedule launches, maintenance windows, and recurring availability patterns.

Multi-Environment

Environment inheritance, promotion workflows, and per-environment configurations.

Admin API

REST endpoints for flag management with RBAC, audit logging, and pagination.

Analytics

Track evaluations, collect metrics, and export to Prometheus for monitoring.

OpenFeature

Vendor-agnostic feature flagging via the OpenFeature standard.

Quick Start¶

app.py¶

from litestar import Litestar, get
from litestar_flags import FeatureFlagsPlugin, FeatureFlagsConfig, FeatureFlagsClient

config = FeatureFlagsConfig()
plugin = FeatureFlagsPlugin(config=config)

@get("/")
async def index(feature_flags: FeatureFlagsClient) -> dict:
    if await feature_flags.is_enabled("dark_mode"):
        return {"theme": "dark"}
    return {"theme": "light"}

app = Litestar(plugins=[plugin])