Skip to main content

modern local environment management

Project description

  ___| |__   ___ _ ____   __
 / __| '_ \ / _ | '_ \ \ / /
| (__| | | |  __| | | \ V /
 \___|_| |_|\___|_| |_|\_/ . modern local environment management

Project Status PyPI Python Version License

Read the documentation at Tests Codecov

pre-commit Black

This command-line interface creates and manages local .env files from various sources.

Coupled with python-dotenv for python, or dotenv for node.js development, it provides better, more consistent environment variable management and developement.


To install chenv, run this command in your terminal:

$ pip install --user chenv

Also make sure that your $PATH includes $HOME/.local/bin. If not, add this line to your .bashrc / .zshrc:

export PATH=$HOME/.local/bin:$PATH;


chenv’s usage looks like:

$ chenv COMMAND [ARGS]

Commands currently include:


Choose to set .env as a new, blank, .env.blank file.


Choose to set .env from a remote heroku app config-vars, as .env.[app-name].

  • -t <team>, --team <team>

    Pre-fill team name

  • -a <app>, --app <app>

    Pre-fill app name


Choose to set .env from a local, pre-exsiting .env.* file.

  • filename

    Pre-fill file-suffix name

Project Configurations

chenv also provides two file types that manipulate the output of new .env.* files being set.


Specifies intentionally unwanted environment-variables. Each line in a envignore file specifies a pattern.

When deciding whether to ignore an environment variable, chenv checks it’s key against the list of patterns described in this file.


.envignore uses the unix filename pattern matching, similar to .gitignore’s, and as specified at


Sepecifies environment variables to merge / override after any input is chosen. This provides consistency to preffered settings such as the logging-level, or NODE_ENV for local development usage in node.js.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chenv-0.4.2.tar.gz (10.9 kB view hashes)

Uploaded Source

Built Distribution

chenv-0.4.2-py3-none-any.whl (13.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page