---
id: stigg-sidecar-sdk
version: "8.0.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# stigg-sidecar-sdk

License: unclear · Maintenance: active · Downloads: 91.1K/mo

## What it is and what it does

stigg-sidecar-sdk is a Python client for the Stigg Sidecar, a service that manages customer entitlements and controls access to metered features. It wraps communication with a separately deployed sidecar instance, allowing you to query whether a customer has access to a feature, request metered entitlements with usage counts, and provision customers through the underlying API.

The SDK is async-first and depends on betterproto for protocol buffer support and stigg-api-client-v2 for the underlying API client. It requires Python 3.9 or later and is actively maintained. The main workflow is to initialize a Stigg client with an API key and sidecar host/port, then call methods like get_metered_entitlement() to check access or use the .api property to perform administrative operations.

Use it for:

- Check whether a customer has access to a metered feature before allowing them to use it.
- Query entitlements with requested usage counts to enforce usage-based billing or rate limits.
- Provision new customers and manage their entitlements programmatically.
- Integrate feature gating into a SaaS application backed by Stigg's subscription management.
- Build access-control logic that respects customer subscription tiers and feature quotas.

## Worth the install?

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

Python SDK for interacting with Stigg Sidecar, a service for managing customer entitlements and feature access control.

Yes, if you are already using Stigg for subscription management and need a Python client for the Sidecar. Low install friction and active maintenance are positive signals. However, verify the license terms before committing—the metadata shows 'unclear' status with no published license text. Confirm that deploying and maintaining a separate sidecar instance fits your architecture.

## Install

pip install stigg-sidecar-sdk
uv add stigg-sidecar-sdk
poetry add stigg-sidecar-sdk

## Installing stigg-sidecar-sdk

Before you install: Low install friction with a pure Python wheel. Actively maintained as of 2 days ago. Depends on betterproto and stigg-api-client-v2, both of which should resolve cleanly.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.

Quickstart:

pip install stigg-sidecar-sdk

import os
from stigg_sidecar_sdk import Stigg, ApiConfig

api_key = os.environ.get("STIGG_SERVER_API_KEY")
stigg = Stigg(
    ApiConfig(api_key=api_key),
    remote_sidecar_host='localhost',
    remote_sidecar_port=80
)

Requires a running Stigg Sidecar instance (typically deployed as a Docker container) accessible at the specified host and port.

Verify before relying:

- Actual license terms—metadata shows 'unclear' treatment with no SPDX or raw license text available.
- Whether the sidecar must be deployed separately or if it can be embedded; documentation link is not accessible in the fact sheet.
- Stability and API surface of stigg-api-client-v2 dependency.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 91.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

entitlement management sdk, feature access control python, customer billing integration, metered entitlement api, stigg sidecar client, subscription feature gating, usage-based access control, entitlement-management, feature-gating, saas-billing

[View on SkillFed](https://skillfed.io/packages/stigg-sidecar-sdk) · [View on PyPI](https://pypi.org/project/stigg-sidecar-sdk/)