ilyakaznacheev/cleanenv

Health v2 · maintenance only

Adoption not part of the score

2160 stars · 132 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A minimalistic Go library for reading application configuration from files (YAML, JSON, etc.) and environment variables into typed structs. It also generates a detailed variable list for help output and supports refreshing environment variables at runtime.

Use cases

• load app config from env vars in Go
• read YAML config file into a struct
• combine file-based and environment-based configuration
• generate a help listing of all config variables
• refresh environment variable values at runtime
• twelve-factor app configuration in Go

When to choose

• you want a small, dependency-light config reader with struct tags
• your app needs env vars to override file-based config
• you prefer explicit typed config structs over dynamic config maps

When to avoid

• you need advanced features like hot-reloading files, validation frameworks, or remote config sources
• you need support for many exotic config file formats beyond the supported ones
• your configuration logic is highly dynamic or nested beyond simple structs

Facets

library · maturity stable

configuration-management developer-tools backend go cross-platform environment-variables config-reader yaml struct-tags twelve-factor automation

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ilyakaznacheev/cleanenv")