doppler-env

What it is and what it does

doppler-env automates the injection of Doppler secrets into Python applications during local development by leveraging Python's site configuration hook. It bridges a gap that exists when debugging in PyCharm or Visual Studio Code, where the IDE's Python entry-point prevents the Doppler CLI from acting as the application runner. Instead of downloading secrets to a .env file, the package fetches secrets via the Doppler CLI (recommended) or directly from the Doppler API using a service token, then injects them into the process environment before your application code runs.

The package requires minimal setup: install it as a dev dependency, set the DOPPLER_ENV environment variable to enable injection, configure your Doppler project and config (either via `doppler setup` or IDE environment variables), and secrets are automatically available to your application. It supports both CLI-based and token-based secret retrieval, making it flexible for restrictive environments where the CLI cannot be used.

Use it for:

• Debug Python applications in PyCharm or VS Code without downloading secrets to disk or .env files.
• Automatically inject Doppler secrets into your local development environment without wrapping commands with `doppler run`.
• Use Doppler service tokens to fetch secrets from the API in restricted environments where the CLI is unavailable.
• Maintain a unified secret management workflow across terminal, IDE, and CI/CD pipelines during development.

Worth the install?

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

Injects Doppler secrets as environment variables into Python applications during local development, with IDE debugging support for PyCharm and Visual Studio Code.

No. The package is abandoned (last release 2022-12-08, repository archived) with no active maintenance. While it has low install friction and a permissive license, the lack of ongoing updates means it may not work with current Python versions, IDE updates, or Doppler API changes. For active Doppler secret injection in development, use the Doppler CLI directly or evaluate actively maintained alternatives.

Install

doppler-env on PyPI

pip install doppler-env

uv add doppler-env

poetry add doppler-env

Installing doppler-env

Before you install

Low install friction with a pure Python wheel and minimal dependencies. However, the package is abandoned as of 2022-12-08 with no recent maintenance, so it may not work reliably with current Python or IDE versions.

License in practice

Licensed under APL 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both personal and commercial projects.

Quickstart

pip install doppler-env

# Set environment variables
export DOPPLER_ENV=1
export DOPPLER_PROJECT=my-project
export DOPPLER_CONFIG=dev

# Run your app—secrets are injected automatically
python app.py

Requires the Doppler CLI installed locally and authenticated via `doppler login`, or a DOPPLER_TOKEN service token for API-based secret fetching.

Verify before relying

• Whether the package still works with Python versions beyond 3.10 or with modern IDE versions.
• Current status of the Doppler CLI and API compatibility with this injection mechanism.
• Whether the site hook approach continues to function reliably across different development environments.

Package facts

Evidence: doppler_env-0.3.1-py3-none-any.whl

Keywords: doppler, environment variables, app secrets, app config, os.environ

Tags

More Utilities packages