coloph-env
Agent-native environment variables in Python.
- Agent-native: The bundled skill teaches coding agents how to use the package correctly.
- Opinionated and strict: Every configuration value is required and validated at process startup.
- Minimal: The small API saves agent attention and reduces integration choices.
- Includes a linter: The linter prevents raw environment access and keeps configuration loading in entrypoints.
- Includes a deployment verifier: It finds missing or invalid values without using local process values.
- Supports common sources: It loads environment variables, dotenv files, TOML files, and CLI flags.
- Supports multiple deployment contexts: Each server, worker, or tool can use one explicit schema.
Unlike Pydantic Settings, Dynaconf, and environs, coloph-env favors strict conventions and agent-friendly tooling over flexibility.
Install
uv add coloph-env
uv run coloph-install-skills
Add this instruction to your project's AGENTS.md:
After installing dependencies, run
uv run coloph-install-skillsto install or update skills bundled with installed packages.
The second command installs the env-variables skill in your project.
Tell your coding agent to use this skill to integrate the package.
The integration can require changes to existing configuration code.
Development
uv sync --group dev
uv run ruff check .
uv run ruff format --check .
uv run mypy
uv run pytest
uv run python scripts/release.py build --tag v0.2.0
Read AGENTS.md for contribution rules. Read docs/releasing.md for release instructions.
1 maintainer
Release files for coloph-env 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| coloph_env-0.2.0.tar.gz | 56.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| coloph_env-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:82.0 kB
Release files / coloph_env-0.2.0.tar.gz
| Download URL | coloph_env-0.2.0.tar.gz |
|---|---|
| Size | 56.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1446b20fb67d3d4d52d52cf91e93d5ef3022818cda82631c03b228ce57d9255c
|
|
BLAKE2b-256 checksum How to use checksums |
6f4cb1c187f927580af9bdb86849cce831b787ebf693a9bd52376f3d18bf4f49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / coloph_env-0.2.0-py3-none-any.whl
| Download URL | coloph_env-0.2.0-py3-none-any.whl |
|---|---|
| Size | 25.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
51f33bea3a27a6034348d9038f679e7c06c6b5386e405fed596adf65d9a34dfb
|
|
BLAKE2b-256 checksum How to use checksums |
56c7de5b417d5c1154a48bb23ceeb3802b571fce460289bcc51583944bbb91ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
