---
id: os-client-config
version: "2.3.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# os-client-config — OpenStack Client Configuation Library

License: permissive · Maintenance: aging · Downloads: 298.6K/mo

## What it is and what it does

os-client-config is a configuration aggregator for OpenStack cloud clients. It reads cloud credentials and settings from multiple sources—configuration files, environment variables, and built-in vendor defaults—and presents them as a unified set of named cloud configurations. This eliminates the need to manually construct credentials or know vendor-specific setup details.

The package is now superseded by openstacksdk, which the project documentation explicitly recommends for new work. While os-client-config continues to exist and receive updates, it functions primarily as a legacy compatibility layer. It depends on openstacksdk and pbr, and requires Python 3.10 or later.

Use it for:

- Reading OpenStack cloud credentials from standard config files and environment variables in a single call
- Supporting multiple named cloud configurations in a single application without hardcoding credentials
- Migrating older OpenStack tooling that relies on os-client-config before transitioning fully to openstacksdk
- Accessing vendor-specific OpenStack defaults without manual configuration

## Worth the install?

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

Collects and manages OpenStack cloud client configuration from files, environment variables, and vendor defaults in a unified way.

No—not for new projects. The package's own documentation explicitly recommends using openstacksdk directly instead. Install only if you are maintaining legacy code that already depends on os-client-config and cannot yet migrate. For new OpenStack integrations, use openstacksdk.

## Install

pip install os-client-config
uv add os-client-config
poetry add os-client-config

## Installing os-client-config

Before you install: Low install friction with only two runtime dependencies. However, the package is aging—last release was 402 days ago—and the project itself explicitly recommends transitioning to openstacksdk directly rather than using this library going forward.

License in practice: Licensed under Apache (permissive), so commercial and proprietary use is permitted without restriction.

Quickstart:

pip install os-client-config

from os_client_config import config

cloud_config = config.OpenStackConfig()
cloud = cloud_config.get_cloud_config(cloud_name='mycloud')

Requires Python 3.10 or later. The package is superseded by openstacksdk; consider using that instead for new projects.

Verify before relying:

- Whether the package remains actively maintained or is in maintenance-only mode despite the aging status
- How well the library integrates with current OpenStack deployments given the explicit recommendation to use openstacksdk instead

## Package facts

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

## Tags

openstack cloud configuration, openstack client config, cloud credential management, openstack environment setup, multi-cloud openstack config, openstack, legacy-maintained

[View on SkillFed](https://skillfed.io/packages/os-client-config) · [View on PyPI](https://pypi.org/project/os-client-config/)