go-zero README

The project's README from github.com/zeromicro/go-zero. As one markdown file: README.md.

go-zero

go-zero is a web and rpc framework with lots of builtin engineering practices. It’s born to ensure the stability of the busy services with resilience design and has been serving sites with tens of millions of users for years.

codecov Go Report Card Release Go Reference Awesome Go License: MIT Discord

🤷‍ What is go-zero?

English | 简体中文 | 한국어

zeromicro%2Fgo-zero | Trendshift go-zero - A web & rpc framework written in Go. | Product Hunt

go-zero (listed in CNCF Landscape: https://landscape.cncf.io/?selected=go-zero) is a web and rpc framework with lots of builtin engineering practices. It’s born to ensure the stability of the busy services with resilience design and has been serving sites with tens of millions of users for years.

go-zero contains simple API description syntax and code generation tool called goctl. You can generate Go, iOS, Android, Kotlin, Dart, TypeScript, JavaScript from .api files with goctl.

Advantages of go-zero:

Architecture

Backgrounds of go-zero

In early 2018, we transitioned from a Java+MongoDB monolithic architecture to microservices, choosing:

Design considerations on go-zero

go-zero follows these core design principles:

The implementation and features of go-zero

go-zero integrates engineering best practices:

Resilience

Architecture with go-zero

image

Installation

Run the following command under your project:

go get -u github.com/zeromicro/go-zero

AI-Native Development

The go-zero team provides workflow guidance and implementation patterns for AI coding assistants such as Claude Code, GitHub Copilot, and Cursor. For assistants with terminal access, the recommended workflow is to run goctl directly to generate framework-compliant code.

AI Tooling Projects

Quick Setup

Install goctl and ensure it is available in your $PATH:

go install github.com/zeromicro/go-zero/tools/goctl@latest
goctl --version

Follow the ai-context setup guide and zero-skills integration guides to configure your assistant's workflow instructions and pattern library.

How It Works

  1. Consult ai-context for the workflow and zero-skills for relevant patterns.
  2. Define the .api or .proto specification, then run goctl in the terminal to generate code.
  3. Implement business logic, resolve dependencies, build, and test the service.

Example: Create a REST API → write the .api specification → run goctl api go → implement the logic using zero-skills patterns → run go mod tidy, go build ./..., and go test ./....

Optional MCP Integration

For clients that use MCP tools, such as Claude Desktop, configure mcp-zero to invoke goctl through MCP. It uses the same code generation engine; assistants with terminal access can use the direct workflow above without an MCP server.

Quick Start

  1. Full examples:

    Rapid development of microservice systems

    Rapid development of microservice systems - multiple RPCs

  2. Install goctl

    # for Go
go install github.com/zeromicro/go-zero/tools/goctl@latest

# For Mac
brew install goctl

# docker for all platforms
docker pull kevinwan/goctl
# run goctl
docker run --rm -it -v `pwd`:/app kevinwan/goctl --help

    Ensure goctl is executable and in your $PATH.

  3. Create the API file (greet.api):

    type (
  Request {
    Name string `path:"name,options=[you,me]"` // parameters are auto validated
  }

  Response {
    Message string `json:"message"`
  }
)

service greet-api {
  @handler GreetHandler
  get /greet/from/:name(Request) returns (Response)
}

    Generate .api template:

    goctl api -o greet.api

  4. Generate Go server code

    goctl api go -api greet.api -dir greet

    Generated structure:

    ├── greet
│   ├── etc
│   │   └── greet-api.yaml        // configuration file
│   ├── greet.go                  // main file
│   └── internal
│       ├── config
│       │   └── config.go         // configuration definition
│       ├── handler
│       │   ├── greethandler.go   // get/put/post/delete routes are defined here
│       │   └── routes.go         // routes list
│       ├── logic
│       │   └── greetlogic.go     // request logic can be written here
│       ├── svc
│       │   └── servicecontext.go // service context, mysql/redis can be passed in here
│       └── types
│           └── types.go          // request/response defined here
└── greet.api                     // api description file

    Run the service:

    cd greet
go mod tidy
go run greet.go -f etc/greet-api.yaml

    Default port: 8888 (configurable in etc/greet-api.yaml)

    Test with curl:

    curl -i http://localhost:8888/greet/from/you

    Response:

    HTTP/1.1 200 OK
Date: Sun, 30 Aug 2020 15:32:35 GMT
Content-Length: 0

  5. Write business logic

    • Pass dependencies (mysql, redis, etc.) via servicecontext.go
    • Add logic code in the logic package per .api definition

  6. Generate client code for multiple languages

    goctl api java -api greet.api -dir greet
goctl api dart -api greet.api -dir greet
...

Benchmark

benchmark

Checkout the test code

Documents

Chat group

Join the chat via https://discord.gg/4JQvC5A4Fe

Cloud Native Landscape

   

go-zero enlisted in the CNCF Cloud Native Landscape.

Give a Star! ⭐

If you like this project or are using it to learn or start your own solution, give it a star to get updates on new releases. Your support matters!

go-zero (zeromicro/go-zero)

Searching Database…

33.4K ·GitHub
Go-zero
Что это такое?go-zero — это cloud-native фреймворк для Go, предназначенный для создания веб- и RPC-микросервисов, со встроенными инженерными практиками. Он уже несколько лет обслуживает сайты с десятками миллионов пользователей и входит в CNCF Landscape.
Это фреймворк или отдельный инструмент для командной строки?И то и другое: ядро — это веб- и RPC-фреймворк для Go, а в комплекте идёт goctl — утилита командной строки, которая превращает простые .api-файлы с описанием в сгенерированный код.
Как запустить сервис?Опишите свой сервис на простом синтаксисе .api, который использует go-zero, и запустите goctl — одна команда генерирует код сервиса, а свою логику вы пишете поверх фреймворка.
Меня заставят отказаться от стандартного HTTP-стека Go?Нет — его простой API сохраняет полную совместимость интерфейсов с net/http, а встроенные middlewares можно встроить и в ваши собственные фреймворки.
Это для больших продакшен-систем или для любительских проектов?Он рассчитан на нагруженные продакшен-сервисы: go-zero спроектирован для стабильной работы при высоких нагрузках и в качестве примеров называет сервисы с десятками миллионов активных пользователей в день.
Какие языки, кроме Go, умеет генерировать goctl?Из тех же .api-файлов он может генерировать Go, iOS, Android, Kotlin, Dart, TypeScript и JavaScript, так что веб- и мобильные клиенты получают SDK прямо из описания сервиса.
Почему команда написала свой фреймворк, а не взяла готовый?В начале 2018 года они переносили монолит на Java+MongoDB в микросервисы: для производительности и низкого потребления ресурсов выбрали Go, а собственный фреймворк — ради лучшей изоляции проблем и более быстрого решения неполадок.
Что я получу из коробки, не написав код отказоустойчивости самому?Встроены последовательный контроль таймаутов, контроль конкурентности, ограничение частоты запросов, адаптивный circuit breaker и адаптивный сброс нагрузки — обычно без всякой настройки; туда же входят обнаружение сервисов, балансировка нагрузки и трассировка вызовов.
Он сам проверяет входящие запросы?Да — параметры клиентских запросов проверяются автоматически, это одна из встроенных инструментов для разработчиков наряду с управлением кешем, метриками и мониторингом.
What are similar projects?kratos, gofr, spring-cloud-alibaba, fiber, grpc-gateway, echo, resty, chi
Which topics is it in?ai-native, restful-api, restful, circuit-breaker, microservices-architecture, service-discovery, spec-driven-development, microservice, rate-limiting, tracing, gateway, load-balancer
Creator
zeromicro
Size
32.4 MB
Stars
33.4K
Updated
CommitOct 18Releasev1.10.3Aug 01
Age
6y
Commits · 90 Days