# jaraco/keyring

Repository: https://github.com/jaraco/keyring
Canonical: https://ross.abutalabs.com/products/keyring
Language: Python
License Family: other
Last push: 2026-04-13T23:34:18+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 77, release rhythm 45, longevity 100
- inputs: {"age_days": 4208, "days_push": 142, "days_rel": 290, "gap_med": 47.0, "n_releases_24m": 5}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1508, forks 195 (observed 2026-08-28T04:04:55.625798+00:00)

## What it is
A Python library providing a simple API to access the operating system's native keyring service for safe password storage and retrieval. It supports macOS Keychain, Windows Credential Locker, Freedesktop Secret Service, and KDE KWallet backends, plus a bundled command-line utility.

## Use cases
- store passwords securely from a python app
- access the system keychain from python
- save credentials without hardcoding them
- retrieve stored passwords on macos keychain
- use windows credential locker from a script
- manage secrets via a keyring command line tool

## When to choose
- you need cross-platform credential storage using the OS-native keyring
- you want to avoid storing passwords in plaintext config files
- you need a simple set_password/get_password API in Python

## When to avoid
- you need cross-machine or cloud-synced secret management
- you need a full secrets manager with rotation and auditing
- your environment has no keyring backend available (e.g. headless servers without a secret service)

## Facets
- artifact type: library
- maturity: stable
- function: security, cryptography, cli
- domain: security, developer-tools, cross-platform
- platform: python, windows, cli
- tags: password-storage, keyring, credentials, system-keychain, secrets, macos, linux

## Member repositories
- jaraco/keyring (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:55.625798+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:32:33.302402+00:00, confidence not recorded.
  - readme: https://github.com/jaraco/keyring (fetched 2026-08-28T04:04:55.625798+00:00, sha d77b5f33faf9)
  - registry_pypi: https://pypi.org/pypi/keyring/json (fetched 2026-08-29T11:36:55.570942+00:00, sha 4007bd36a071)
- Data as of 2026-08-30T08:39:29.467469+00:00.