go-kratos /kratos

Your ultimate Go microservices framework for the cloud-native era.

★ 26,030⑂ 4,179👁 433⑃ 2,570● 1,284▤ 73
GoMITCreated 2019-01-10go-kratos.dev
Download: v3.0.0v3.0.0 ↓3.0.02026-06-26
+0
Daily
+21
Weekly
+55
Monthly
26,030
stars
4,179
forks
433
watchers
2,570
prs
1,284
issues
73
releases

README

Translations: English | 简体中文

 Kratos

Kratos is a lightweight Go framework for building cloud-native microservices. It provides small, explicit APIs for transport, middleware, registry, configuration, logging, encoding, and code generation so applications can focus on business logic.

 Features

- API-first development with Protobuf and generated HTTP/gRPC code.
- Unified transport layer for HTTP and gRPC.
- Composable middleware for recovery, logging, validation, tracing, metrics, auth, and more.
- Pluggable registry, configuration, and encoding components.
- Standard-library log/slog based logging with OpenTelemetry extensions in contrib packages.
- Consistent metadata, errors, validation, OpenAPI, and code-generation workflows.
- A contrib ecosystem for optional integrations such as registries, config stores, middleware, encodings, and observability.

 Installation

 Requirements

- Go 1.25 or later
- protoc
- protoc-gen-go

 Install the CLI

shell
go install github.com/go-kratos/kratos/cmd/kratos/v3@latest
kratos upgrade


 Create a Service

shell
kratos new helloworld
cd helloworld
go mod tidy
kratos run


Visit http://localhost:8000/helloworld/kratos after the service starts.

For a fuller generated service flow:

shell
kratos proto add api/helloworld/helloworld.proto
kratos proto client api/helloworld/helloworld.proto
kratos proto server api/helloworld/helloworld.proto -t internal/service
go generate ./...
kratos run


 Usage Example

go
package main

import (
	"github.com/go-kratos/kratos/v3"
	"github.com/go-kratos/kratos/v3/transport/grpc"
	"github.com/go-kratos/kratos/v3/transport/http"
)

func main() {
	httpSrv := http.NewServer(http.Address(":8000"))
	grpcSrv := grpc.NewServer(grpc.Address(":9000"))

	app := kratos.New(
		kratos.Name("helloworld"),
		kratos.Version("v1.0.0"),
		kratos.Server(httpSrv, grpcSrv),
	)
	if err := app.Run(); err != nil {
		panic(err)
	}
}


 v3 Migration

Kratos v3 reduces core dependencies and makes previously implicit behavior explicit. Review the v2 to v3 migration guide before upgrading production services.

 Further Reading

- Documentation
- Examples
- Project Layout
- v2 to v3 Migration Guide
- Community Contribution Guide

 Development

shell
make test
make lint


 Community

- Documentation
- WeChat Group
- Discord Group
- Discussions

 Security

If you discover a security vulnerability in Kratos, please contact [email protected]. Security reports are handled privately before disclosure.

 Contributors

Thank you for contributing to Kratos. The contribution guide is available in the Kratos documentation.


  


 Acknowledgments

The following projects influenced Kratos design:

- go-kit/kit
- go-micro
- google/go-cloud
- go-zero
- beego

 License

Kratos is open-sourced software licensed under the MIT license.

Top issues

Discussions

Latest release

v3.0.0 v3.0.0 2026-06-26
Breaking Changes
- break: update kratos modules to v3 (3822)
 New Features
- feat(errors): add standard library errors wrappers (3844)
- feat(transport/http): add read/write deadline control to ServerStream (3843)
- feat(protoc-gen-go-http): support google.api.HttpBody response (3839)
- feat(config): add generic config Get support (3778)
- feat(middleware/auth/jwt): add WithParserOptions to allow configuring… (3803)
- feat: support pre condition failed code mapping (3795)
- feat(cmd): add --repo flag to kratos new command (3789)
- feat(errors): add TooManyRequests error type (3787)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON