python-dotenv

Read key-value pairs from a .env file and set them as environment variables

python-dotenv Permissive license BSD-3-Clause Active ★ 8,845 v1.2.2 released 2026-03-01

Install

python-dotenv on PyPI

pip

pip install python-dotenv

uv

uv add python-dotenv

poetry

poetry add python-dotenv

Package facts

License	BSD-3-Clause (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	none
Maintenance	actively maintained — 165 days since the last release
Last repo commit	2026-07-26
First released	2014-09-08
Popularity	one of the 100 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: python_dotenv-1.2.2-py3-none-any.whl

Keywords: environment variables, deployments, settings, env, dotenv, configurations, python

Development Status :: 5 - Production/StableEnvironment :: Web EnvironmentIntended Audience :: DevelopersIntended Audience :: System AdministratorsOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: PyPyTopic :: System :: Systems AdministrationTopic :: Utilities

About python-dotenv

from the package's own PyPI description — quoted content, verbatim

python-dotenv

[![Build Status][build_status_badge]][build_status_link] [![PyPI version][pypi_badge]][pypi_link]

python-dotenv reads key-value pairs from a .env file and can set them as environment variables. It helps in the development of applications following the 12-factor principles.

Getting Started
Other Use Cases
Load configuration without altering the environment
Parse configuration as a stream
Load .env files in IPython
Command-line Interface
File format
Multiline values
Variable expansion
Related Projects
Acknowledgements

Getting Started

pip install python-dotenv

If your application takes its configuration from environment variables, like a 12-factor application, launching it in development is not very practical because you have to set those environment variables yourself.

To help you with that, you...

Read as markdown · JSON record · Source repository