# 使用 Homebrew 安装 keyring

查看 keyring 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

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

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install keyring
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:keyring
- **软件包管理器:** Homebrew
- **版本:** 25.7.0
- **来源摘要:** Easy way to access the system keyring service from python
- **主页:** <https://github.com/jaraco/keyring>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- keyring (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 25.7.0
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <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/>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- 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

## Combined YAML source

View the package source record on GitHub. [combined/keyring.yml](https://github.com/mxcl/pkgdb/blob/main/combined/keyring.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
