keyring

Store and access your passwords safely.

keyring Permissive license MIT Active ★ 1,503 v25.7.0 released 2025-11-16

Install

keyring on PyPI

pip

pip install keyring

uv

uv add keyring

poetry

poetry add keyring

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	7 — pywin32-ctypes, SecretStorage, jeepney, importlib_metadata, jaraco.classes, jaraco.functools, jaraco.context
Maintenance	actively maintained — 270 days since the last release
Last repo commit	2026-04-13
First released	2009-08-21
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: keyring-25.7.0-py3-none-any.whl

Development Status :: 5 - Production/StableIntended Audience :: DevelopersProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: Only

About keyring

from the package's own PyPI description — quoted content, verbatim

.. image:: https://img.shields.io/pypi/v/keyring.svg :target: https://pypi.org/project/keyring

.. image:: https://img.shields.io/pypi/pyversions/keyring.svg

.. image:: https://github.com/jaraco/keyring/actions/workflows/main.yml/badge.svg :target: https://github.com/jaraco/keyring/actions?query=workflow%3A%22tests%22 :alt: tests

.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff

.. image:: https://readthedocs.org/projects/keyring/badge/?version=latest :target: https://keyring.readthedocs.io/en/latest/?badge=latest

.. image:: https://img.shields.io/badge/skeleton-2025-informational :target: https://blog.jaraco.com/skeleton

.. image:: https://tidelift.com/badges/package/pypi/keyring :target: https://tidelift.com/subscription/pkg/pypi-keyring?utm_source=pypi-keyring&utm_medium=readme

.. image:: https://badges.gitter.im/jaraco/keyring.svg :alt: Join the chat at https://gitter.im/jaraco/keyring :target: https://gitter.im/jaraco/keyring?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

The Python...

Read as markdown · JSON record · Source repository

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Keyring provides safe, system-level password storage and retrieval for Python applications, integrating with native credential managers on macOS, Linux, and Windows.

Low friction: pure-wheel distribution with 7 runtime dependencies that are mostly lightweight metadata and utility libraries. Active maintenance (last commit 2026-04-13, 270 days since release) and 1503 GitHub stars signal stability.

MIT license permits commercial and private use with minimal restrictions—you may use, modify, and distribute keyring freely as long as you include the license notice.

Usage

import keyring
keyring.set_password("system", "username", "password")
password = keyring.get_password("system", "username")
print(password)

Requires Python 3.9+. On Linux, KWallet backend depends on dbus-python which may require system-level compilation; install as a system package for best results.

Verdict: Keyring is a mature, actively maintained library (Production/Stable since 2009) with no known vulnerabilities, low install friction, and permissive MIT licensing. It is suitable for any application needing secure credential storage across platforms, though Linux users should be aware of optional dbus-python compilation overhead.

Needs verification

Whether SecretStorage, pywin32-ctypes, and jeepney are always required or only loaded conditionally by platform-specific backends.
Performance characteristics and overhead of credential lookups across different backend implementations.

system password storage pythonsecure credential managementkeychain integrationpassword vault accesssystem keyring backendcredential locker pythonsecret service dbus