kelseyhightower/envconfig

Health v2 · maintenance only

Adoption not part of the score

5466 stars · 395 forks observed · 2026-08-28

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

A Go library that populates struct fields from environment variables using struct tags for overrides, defaults, and required values. It supports types like slices, maps, and time.Duration with automatic parsing.

Use cases

• load configuration from environment variables in Go
• parse env vars into a struct with defaults
• require certain environment variables at startup
• map env vars to snake_case names automatically
• twelve-factor app configuration in Go

When to choose

• you want lightweight, dependency-free env var config in Go
• you prefer struct-tag-driven configuration with defaults and required checks
• you need parsing of durations, slices, and maps from env vars

When to avoid

• you need config from files, YAML, or multiple sources
• you want hot-reloading or validation beyond required/default
• you're not using Go

Facets

library · maturity maintenance

configuration-management developer-tools developer-tools backend go cross-platform environment-variables struct-tags twelve-factor-app config-parsing devops

Member repositories

For agents

markdown · JSON · MCP: product_card(name="kelseyhightower/envconfig")