# Install keyring with Homebrew

Easy way to access the system keyring service from python. Version 25.7.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:keyring
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install keyring
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:keyring
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/keyring>
- **Version:** 25.7.0
- **Source summary:** Easy way to access the system keyring service from python
- **Homepage:** <https://github.com/jaraco/keyring>
- **Repository:** <https://github.com/jaraco/keyring>
- **Upstream docs:** <https://keyring.readthedocs.io/en/latest>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/43/4b/674af6ef2f97d56f0ab5153bf0bfa28ccb6c3ed4d1babf4305449668807b/keyring-25.7.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- keyring (cli)
- keyring (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 25.7.0
- Local data: ok
- Upstream repository: https://github.com/jaraco/keyring
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Python keyring is the common Python library and command-line tool for storing and retrieving secrets through the operating system credential store. It gives Python applications one API over macOS Keychain, Freedesktop Secret Service/libsecret, KDE KWallet, Windows Credential Manager, and extension backends.

### Project history

The project began as python-keyring-lib and later settled into the jaraco/keyring repository. A 2014 maintainer announcement moved hosting from Bitbucket to GitHub, preserving issues and source history while aligning development with GitHub and Travis CI workflows of that period.

The project steadily narrowed and modularized its backend surface. Less preferred or risky backends were split into keyrings.alt, while the main package concentrated on recommended system keyrings and a CLI/API that applications could call safely.

### Adoption history

keyring became infrastructure in the Python packaging and developer-tools ecosystem because tools can use it for credentials without inventing their own password storage. PyPI release history, Read the Docs documentation, and downstream packages show a long-lived library with regular maintenance across Python and operating-system changes.

### How it is used

Applications call keyring.set_password, get_password, or credential APIs, while users can invoke the keyring command to inspect or manage secrets. The package chooses a viable backend for the environment, and users can configure explicit backends through keyringrc.cfg when automatic selection is not enough.

### Why package nerds care

keyring is small but central because it connects Python packaging, CLIs, desktop secret stores, and enterprise artifact repositories. It is also a useful example of packaging security posture: plaintext and weaker backends were moved to an alternate package rather than silently remaining first-class defaults.

### Timeline

- 2014: The maintainer announced the move from Bitbucket to GitHub under jaraco/keyring.
- 2010s: The project supported the major desktop credential stores through a unified Python API.
- 2017: Legacy and less preferred backends were split toward keyrings.alt, reducing the default backend surface.
- 2024: v24 removed older macOS and utility modules while retaining the main credential-store API.
- 2025: v25 releases continued backend and CLI maintenance, including KWallet 6 support.

### Related projects

- Related projects include keyrings.alt for alternate backends, SecretStorage/libsecret for Linux Secret Service integration, pywin32-ctypes for Windows credential access, KWallet bindings, pip/twine-style packaging clients, and cloud artifact-registry keyring plugins.

### Sources

- <https://github.com/jaraco/keyring>
- <https://groups.google.com/g/python-keyring/c/m62BwNm5Wc8>
- <https://keyring.readthedocs.io/en/latest>
- <https://keyring.readthedocs.io/en/latest/history.html>
- <https://pypi.org/project/keyring/>
- <https://pypi.org/project/keyrings.alt/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: keyringrc.cfg
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** keyring
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [git-credential-libsecret](https://www.automicvault.com/pkg/brew/git-credential-libsecret/) - Shares av.db curated category or tags: cli, credential-management, credentials, security.
- [git-credential-oauth](https://www.automicvault.com/pkg/brew/git-credential-oauth/) - Shares av.db curated category or tags: cli, credential-management, credentials, security.
- [libsecret](https://www.automicvault.com/pkg/brew/libsecret/) - Shares av.db curated category or tags: cli, credential-management, credentials, security.
- [keychain](https://www.automicvault.com/pkg/brew/keychain/) - Shares av.db curated category or tags: cli, credential-management, security.
- [leapp-cli](https://www.automicvault.com/pkg/brew/leapp-cli/) - Shares av.db curated category or tags: cli, credential-management, security.
- [afflib](https://www.automicvault.com/pkg/brew/afflib/) - Shares av.db curated category or tags: cli, library, security.
- [apkleaks](https://www.automicvault.com/pkg/brew/apkleaks/) - Shares av.db curated category or tags: cli, secrets, security.
- [bandit](https://www.automicvault.com/pkg/brew/bandit/) - Shares av.db curated category or tags: cli, python, security.
- [credstash](https://www.automicvault.com/pkg/brew/credstash/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, credentials, management, python, python-3-14.
- [envchain](https://www.automicvault.com/pkg/brew/envchain/) - Security-sensitive metadata or terminology overlaps. Shared terms: cli, credentials, keyring, management, secrets.

## Combined YAML source

View the package source record on GitHub. [combined/keyring.yml](https://github.com/automic-vault/db/blob/main/combined/keyring.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
