ButterflyGo Microservice Framework

A lightweight framework for building microservices in Go

Configuration Management

Supports file-based YAML and Consul configuration center, with flexible environment variable overrides using the BUTTERFLY_ prefix.

Built-in HTTP server (Gin), gRPC server on port 9090, and Twirp RPC support out of the box.

Integrated support for GORM, MongoDB, Redis, native SQL, and S3-compatible object storage (AWS SDK v2).

Prometheus metrics on port 2223, OpenTelemetry distributed tracing, and structured logging via log/slog.

Google Wire integration for compile-time dependency injection, improving testability and maintainability.

Graceful shutdown, health checks, Docker & Kubernetes deployment support, and testing utilities built in.