---
id: python-keystoneclient
version: "5.8.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# python-keystoneclient — Client Library for OpenStack Identity

License: permissive · Maintenance: active · Downloads: 1.2M/mo

## What it is and what it does

python-keystoneclient is the official Python client library for OpenStack's Keystone Identity service. It provides a programmatic interface to authenticate users, manage projects and users, handle tokens, and interact with the broader OpenStack Identity API. The library wraps HTTP calls to a Keystone server and exposes them as Python objects and methods, abstracting away the REST protocol details.

Typically used in OpenStack deployments to build automation tools, CLI applications, or services that need to authenticate against Keystone or perform identity management operations. It integrates with keystoneauth1 for flexible authentication strategies and relies on oslo libraries for configuration, serialization, and internationalization. The package is maintained by the OpenStack community and supports Python 3.10, 3.11, and 3.12.

Use it for:

- Authenticate applications against an OpenStack Keystone service to obtain tokens for accessing other OpenStack APIs.
- Automate user and project provisioning in OpenStack environments programmatically.
- Build custom CLI tools or management scripts that interact with Keystone's identity and access control features.
- Integrate OpenStack identity operations into Python-based infrastructure-as-code or orchestration workflows.
- Query and manage project hierarchies, roles, and service catalogs in OpenStack deployments.

## Worth the install?

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

Python client library for authenticating with and managing OpenStack Identity (Keystone) services, providing programmatic access to user, project, and token operations.

Yes, if you are building applications or tools that interact with OpenStack Keystone. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is the standard client for this purpose. Not relevant for non-OpenStack environments.

## Install

pip install python-keystoneclient
uv add python-keystoneclient
poetry add python-keystoneclient

## Installing python-keystoneclient

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (168 days ago). Depends on 10 runtime packages including keystoneauth1 for authentication and oslo libraries for configuration and serialization.

License in practice: Licensed under Apache Software License (permissive), allowing use in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install python-keystoneclient

from keystoneauth1.identity import v3
from keystoneauth1 import session
from keystoneclient.v3 import client

auth = v3.Password(auth_url="http://example.com:5000/v3",
                   username="admin", password="password",
                   project_name="admin", user_domain_id="default",
                   project_domain_id="default")
sess = session.Session(auth=auth)
keystone = client.Client(session=sess)
keystone.projects.list()

Requires Python 3.10 or later; requires a running OpenStack Keystone service with network access.

Verify before relying:

- Whether keystoneauth1 is the recommended authentication path or if direct token-based auth is also supported.
- Performance characteristics when managing large numbers of projects or users.
- Compatibility with non-standard or custom Keystone deployments.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

openstack identity client, keystone authentication python, openstack api bindings, keystone token management, openstack project management, identity service client, openstack user management, openstack, identity-management, cloud-infrastructure

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