knadh/koanf

Health v2 · maintenance only

Adoption not part of the score

4178 stars · 201 forks observed · 2026-08-28

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

Koanf is a lightweight, extensible configuration management library for Go that reads configuration from multiple sources and formats. It uses a modular Provider/Parser architecture with pluggable backends like files, env vars, CLI flags, S3, Vault, Consul, and etcd.

Use cases

• load app config from yaml, toml, or files in Go
• read configuration from environment variables and command line flags
• load config from S3, Vault, Consul, or etcd
• watch config files for changes and hot-reload
• merge configuration from multiple sources with custom merge strategies
• find a lighter alternative to viper

When to choose

• you need multi-source, multi-format config loading in Go with minimal dependencies
• you want pluggable providers/parsers and custom merge logic
• viper feels too heavy or its abstractions don't fit

When to avoid

• you need a full-featured config system with built-in remote key/value watching semantics like viper's ecosystem
• your project is not in Go

Facets

library · maturity stable

configuration-management developer-tools backend go cross-platform config-loader viper-alternative lightweight yaml toml environment-variables s3 etcd vault

Member repositories

For agents

markdown · JSON · MCP: product_card(name="knadh/koanf")