go-eagle
A Go framework for rapid development of API services and microservices with a layered architecture.
What is go-eagle?
Eagle is a Go framework designed for rapid business development, enabling developers to quickly build robust API services or web applications. It provides a comprehensive set of components, including support for HTTP APIs with Gin and RPC services with gRPC, and follows a clean, layered architecture to streamline microservice and API development.
Go developers and teams building scalable microservices, API services, or web applications who need a production-ready framework with integrated components for data management, messaging, observability, and service discovery.
Developers choose Eagle for its opinionated, batteries-included approach that reduces boilerplate and accelerates development by integrating best-in-class libraries like GORM, Redis, Elasticsearch, and OpenTelemetry into a cohesive, modular framework with dependency injection via Wire.
Overview
🦅 A Go framework for the API or Microservice
Use Cases
Best For
- Rapidly developing production-ready microservices with built-in service discovery (etcd, Consul, Nacos) and observability (Prometheus, Grafana, OpenTelemetry).
- Building scalable API services that require both HTTP (via Gin) and gRPC endpoints with unified configuration and logging.
- Applications needing integrated data management with support for multiple databases (GORM for SQL, MongoDB), caching (Redis, Ristretto), and search (Elasticsearch).
- Implementing event-driven architectures with message queues (RabbitMQ, Redis-based) and scheduled tasks (cron).
- Teams adopting a clean, layered architecture with dependency injection (Wire) to enforce modularity and reduce coupling in business logic.
- Projects requiring comprehensive development tooling including input validation (validator), authentication (JWT), and CI/CD integration (GitHub Actions, Docker, Kubernetes).
Not Ideal For
- Small-scale prototypes or MVPs where minimal setup and rapid iteration trump architectural rigor
- Teams preferring a DIY approach with non-standard components not integrated by Eagle (e.g., alternative ORMs or HTTP frameworks)
- Applications requiring native real-time features like WebSockets, as Eagle focuses on HTTP/RPC and message queues
- Environments with tight resource constraints where the overhead of bundled services (e.g., Prometheus, Elasticsearch) is prohibitive
Pros & Cons
Pros
Eagle bundles best-in-class libraries like Gin, GORM, and OpenTelemetry, reducing boilerplate and accelerating development, as shown in its comprehensive feature list.
The framework enforces modularity with a clean separation of concerns using Wire for dependency injection, promoting maintainability in microservices.
Built-in support for Prometheus, Grafana, and OpenTelemetry provides out-of-the-box monitoring and tracing, essential for scalable systems.
The included `eagle` CLI tool generates project skeletons quickly, streamlining initial setup as demonstrated in the Quick Start section.
Cons
The opinionated architecture and numerous integrated components require significant upfront learning, especially for developers new to microservices patterns.
Being tightly coupled with specific libraries (e.g., Gin for HTTP, GORM for ORM) makes swapping alternatives difficult without framework modifications.
Managing configurations for multiple environments and integrated services can become complex, as evidenced by the detailed directory structure and config files.
Frequently Asked Questions
Related Projects
Go-zeroA cloud-native Go microservices framework with cli tool for productivity.
go-kitA standard library for microservices.
KratosYour ultimate Go microservices framework for the cloud-native era.
grpc-goThe Go language implementation of gRPC. HTTP/2 based RPC
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.