---
id: pulumi-esc-sdk
version: "0.14.0"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# pulumi-esc-sdk — ESC (Environments, Secrets, Config) API

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

## What it is and what it does

Pulumi ESC SDK is a Python client library for the ESC (Environments, Secrets, Config) API, generated from OpenAPI specifications. It allows you to programmatically compose, manage, and retrieve hierarchical collections of configuration values and secrets. The package is built on standard HTTP and serialization libraries (urllib3, pydantic, pyyaml) to provide a type-safe interface to ESC operations.

This is typically used in infrastructure-as-code workflows where you need to fetch or manage environment-specific configuration and secrets from a centralized ESC service. It integrates with the Pulumi ecosystem but functions as a standalone client for any application needing to consume ESC-managed configuration.

Use it for:

- Fetch environment-specific secrets and configuration in Pulumi infrastructure code
- Manage hierarchical configuration collections across multiple deployment environments
- Programmatically retrieve ESC-stored secrets in application startup or CI/CD pipelines
- Compose and organize configuration values with inheritance and overrides
- Integrate centralized secrets management into Python applications

## Worth the install?

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

Pulumi ESC SDK provides a Python client for composing, managing, and consuming hierarchical collections of configuration and secrets through the ESC API.

Yes. The package has low install friction, active maintenance, permissive licensing, no known vulnerabilities, and solid dependency choices. It is well-positioned for projects using Pulumi ESC or needing a Python client for ESC-managed configuration and secrets. Install it if you need programmatic access to ESC environments.

## Install

pip install pulumi-esc-sdk
uv add pulumi-esc-sdk
poetry add pulumi-esc-sdk

## Installing pulumi-esc-sdk

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance status with a release within the last 60 days. Runtime dependencies are all common, well-maintained libraries (urllib3, pydantic, python-dateutil, pyyaml, typing-extensions).

License in practice: Apache 2.0 is a permissive license that allows commercial and private use with minimal restrictions, requiring only preservation of license and copyright notices.

Quickstart:

pip install pulumi-esc-sdk

from pulumi_esc_sdk import Client

client = Client()
# Access ESC environments and secrets

Verify before relying:

- Whether the package supports all modern Python versions or has undocumented version constraints
- Completeness of API coverage relative to the full ESC service
- Performance characteristics for large configuration hierarchies

## Package facts

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

## Tags

environment secrets config management, pulumi esc api client, hierarchical configuration management, secrets management sdk, environment configuration composition, pulumi infrastructure secrets, config and secrets api, secrets-management, configuration-management, pulumi-ecosystem

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