---
id: openfeature-provider-unleash
version: "0.1.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# openfeature-provider-unleash — OpenFeature provider for Unleash

License: permissive · Maintenance: active · Downloads: 105.6K/mo

## What it is and what it does

This package bridges Unleash feature flag management and the OpenFeature SDK, a vendor-neutral abstraction layer for feature flags in Python. It wraps the UnleashClient and exposes flag evaluation through OpenFeature's standardized API, allowing you to evaluate boolean, string, integer, float, and object flags with context-aware targeting. The provider maps OpenFeature's EvaluationContext (targeting_key and attributes) to Unleash's context model and emits events when the provider is ready, encounters errors, or flag configurations change. You configure it with an Unleash server URL, application name, and API token, then set it as the active provider in the OpenFeature SDK.

Typical use is in applications that want to decouple feature flag logic from a specific vendor—you write flag evaluation code against OpenFeature's API, and this provider handles the Unleash-specific protocol and state management. It supports event handlers for monitoring provider lifecycle and flag changes, and provides a shutdown method for clean teardown. The package is actively maintained, has no known vulnerabilities, and carries a permissive Apache-2.0 license.

Use it for:

- Standardize feature flag evaluation across a Python codebase by using OpenFeature's unified API instead of direct Unleash client calls.
- Migrate from another feature flag provider to Unleash without rewriting application flag evaluation logic—swap the provider implementation.
- Monitor flag state changes and provider errors in real time using OpenFeature event handlers for operational visibility.
- Implement context-aware targeting by mapping user IDs and session attributes from your application context to Unleash evaluation rules.
- Evaluate variant flags (string, integer, float, object payloads) to power A/B tests, canary deployments, or dynamic configuration.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Unleash feature flags with OpenFeature SDK, enabling standardized flag evaluation and context-aware feature toggling in Python applications.

Yes. The package is actively maintained, has zero known vulnerabilities, low install friction, and a permissive license. Install it if you are already using OpenFeature SDK and want Unleash as your flag provider, or if you want to standardize flag evaluation across multiple vendors. Not necessary if you are using Unleash directly without OpenFeature abstraction.

## Install

pip install openfeature-provider-unleash
uv add openfeature-provider-unleash
poetry add openfeature-provider-unleash

## Installing openfeature-provider-unleash

Before you install: Low friction installation with a pure Python wheel. Active maintenance—last commit 2026-08-12, 151 days since latest release. Depends on openfeature-sdk and unleashclient, both standard runtime dependencies.

License in practice: Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions; attribution required but no copyleft obligations.

Quickstart:

pip install openfeature-provider-unleash

from openfeature import api
from openfeature.contrib.provider.unleash import UnleashProvider

provider = UnleashProvider(
    url="https://my-unleash-instance.com",
    app_name="my-python-app",
    api_token="my-api-token"
)
provider.initialize()
api.set_provider(provider)

client = api.get_client()
is_enabled = client.get_boolean_value("my-feature", False)

Requires Python 3.9+, openfeature-sdk>=0.8.2, and UnleashClient>=6.3.0; provider.initialize() must be called before flag evaluation.

Verify before relying:

- Whether variant payload parsing (string, integer, float, object types) handles all Unleash payload formats correctly
- Performance characteristics under high-frequency flag evaluation or large context attribute sets
- Whether PROVIDER_STALE event support is planned or deprecated

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 105.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

feature flag provider openfeature, unleash integration python, feature toggle management sdk, openfeature unleash provider, flag evaluation context mapping, feature flag orchestration, unleash client wrapper, feature-flags, openfeature, unleash

[View on SkillFed](https://skillfed.io/packages/openfeature-provider-unleash) · [View on PyPI](https://pypi.org/project/openfeature-provider-unleash/)