onepassword

What it is and what it does

onepassword is a thin Python wrapper around the 1Password command-line interface, allowing you to authenticate to a 1Password vault and retrieve secrets, documents, and other items programmatically. You pass in your credentials and organization details once, then use simple methods like `list()` and `get()` to query vault contents by item type and UUID.

The package is designed for automation scenarios where you need to fetch credentials or configuration from 1Password during application startup or runtime. It has no external Python dependencies, making installation straightforward. However, it requires the 1Password CLI tool to be installed and accessible on your system—the package is purely a Python interface to that CLI, not a standalone implementation.

Use it for:

• Retrieve API keys or database credentials from 1Password during application initialization.
• Automate certificate or key rotation by fetching updated PEM files from a 1Password vault.
• Build a secrets-management layer for CI/CD pipelines that pulls credentials on demand.
• Query 1Password documents or notes programmatically as part of a larger automation workflow.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Wrapper around the 1Password CLI that lets you query and retrieve secrets, documents, and credentials from a 1Password vault programmatically.

No. The package is abandoned (last update 2020-06-26, repository archived) and has received no maintenance since its latest release. While the MIT license is permissive and install friction is low, the lack of updates means no compatibility fixes for modern Python or 1Password CLI versions. For new projects, use the official 1Password CLI directly or a maintained third-party integration instead.

Install

onepassword on PyPI

pip install onepassword

uv add onepassword

poetry add onepassword

Installing onepassword

Before you install

Low install friction, but the package is abandoned as of June 2020 with no updates since its latest release. The repository is archived and unmaintained, so expect no bug fixes or compatibility updates.

License in practice

MIT license is permissive and poses no restrictions on use, modification, or distribution.

Quickstart

pip install onepassword

from onepassword import OnePassword

secret = {"password": "<YOUR-PASSWORD>",
          "username": "<YOUR-USERNAME>",
          "signin_address": "<YOUR-1PASSWORD-ORGANIZATION-ADDRESS>",
          "secret_key": "<YOUR-1PASSWORD-SECRET-KEY>"}
op = OnePassword(secret=secret)
documents = op.list("documents")
key_contents = op.get("document", documents[0]["uuid"])

Requires 1Password CLI to be installed and configured on the system; the package is a wrapper around it, not a standalone implementation.

Verify before relying

• Whether the package still works with current 1Password CLI versions, given the last update was 2020-06-26.
• Compatibility with Python versions beyond 3.8, despite classifier support for 3.6, 3.7, 3.8.
• Whether the underlying 1Password CLI API has changed since the package's last release.

Package facts

Evidence: onepassword-0.4.1-py3-none-any.whl

Tags

More Security packages