---
id: secretstorage
version: "3.5.0"
license: BSD-3-Clause
license_treatment: permissive
maintenance: aging
---

# SecretStorage — Python bindings to FreeDesktop.org Secret Service API

License: permissive · Maintenance: aging · Popularity: top 1,000 on PyPI

## Install

pip install secretstorage
uv add secretstorage
poetry add secretstorage

## Description

.. image:: https://github.com/mitya57/secretstorage/workflows/tests/badge.svg
   :target: https://github.com/mitya57/secretstorage/actions
   :alt: GitHub Actions status
.. image:: https://codecov.io/gh/mitya57/secretstorage/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/mitya57/secretstorage
   :alt: Coverage status
.. image:: https://readthedocs.org/projects/secretstorage/badge/?version=latest
   :target: https://secretstorage.readthedocs.io/en/latest/
   :alt: ReadTheDocs status

Module description
==================

This module provides a way for securely storing passwords and other secrets.

It uses D-Bus `Secret Service`_ API that is supported by GNOME Keyring,
KWallet (since version 5.97) and KeePassXC.

The main classes provided are ``secretstorage.Item``, representing a secret
item (that has a *label*, a *secret* and some *attributes*) and
``secretstorage.Collection``, a place items are stored in.

SecretStorage supports most of the functions provided by Secret Service,
including creating and deleting items and collections, editing items,
locking and unlocking collections.

The documentation can be found on `secretstorage.readthedocs.io`_.

.....

## AI interpretation — verify before relying

Provides Python bindings to the FreeDesktop Secret Service API, enabling secure storage and retrieval of passwords and secrets through GNOME Keyring, KWallet, or KeePassXC.

Verdict: Stable, low-friction package for integrating with system secret managers on Linux. No known vulnerabilities and permissive licensing make it safe to adopt. Aging maintenance (263 days since release) is typical for a mature, focused library; active repository signals ongoing support. Best suited for applications needing secure credential storage on POSIX systems.

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