envdo

[ 中文 | English ]

Configure environment variables for Python code or command-line programs, providing dotenv management with group-based switching.

Features

• Group Environment Configuration - Configure a set of environment variables for programs without affecting the system environment
• Multi-Environment Management - Support multiple environment configurations for quick switching
• Sensitive Information Protection - Automatically hide sensitive information (TOKEN, KEY, PASSWORD, etc.)
• Interactive Selection - Support interactive environment configuration selection
• Clear Output - Use the rich library for clear terminal output

Installation

pip install envdo

pip install git+https://github.com/NewToolAI/envdo.git

Configuration

Create a configuration file .envdo.json (in project directory) or ~/.envdo.json (in user directory):

{
    "deepseek-3.2": {
        "ANTHROPIC_MODEL": "deepseek-reasoner",
        "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "your-token-here"
    },
    "glm-4.7": {
        "ANTHROPIC_MODEL": "glm-4.7",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "your-token-here"
    },
    "claude-opus": {
        "ANTHROPIC_MODEL": "claude-opus-4-5",
        "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
        "ANTHROPIC_AUTH_TOKEN": "your-token-here",
        "HTTP_PROXY": "http://127.0.0.1:7890",
        "HTTPS_PROXY": "http://127.0.0.1:7890",
        "NO_PROXY": "localhost,127.0.0.1"
    }
}

Programmatic Usage

from envdo import load_envdo

load_envdo('example-1')

Command Line Usage

List All Environment Configurations

envdo list

Interactive Environment Selection

envdo select <command>

Run Command with Specified Environment

envdo gpt-5.2 <command>

Edit Configuration File

envdo e
envdo edit

Opens the currently used .envdo.json (project directory first, then ~/.envdo.json) in your editor. The editor is resolved via $VISUAL / $EDITOR (both support arguments such as code --wait), defaulting to vi. envdo e opens the file even if its JSON is currently invalid, so you can repair it; the file is validated after the editor closes.

Other Commands

envdo -v          # Show version
envdo --version
envdo -h          # Show help
envdo --help
envdo e           # Edit the currently used .envdo.json file
envdo edit

Configuration Notes

• Configuration file priority: .envdo.json in current directory > ~/.envdo.json in user directory
• On first run, if the configuration file does not exist, an example configuration file will be automatically created
• Sensitive information (containing keywords TOKEN, KEY, PASSWORD, SECRET, AUTH, CREDENTIAL, etc.) will be automatically displayed as ***
• Editor priority for envdo e: $VISUAL > $EDITOR > vi

License

MIT License