# jzero

**Repository Path**: holiat/jzero

## Basic Information

- **Project Name**: jzero
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-08
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jzero

[![Build Status](https://img.shields.io/github/actions/workflow/status/jzero-io/jzero/ci.yaml?branch=main&label=jzero-ci&logo=github&style=flat-square)](https://github.com/jzero-io/jzero/actions?query=workflow%3Ajzero-ci)
[![GitHub release](https://img.shields.io/github/release/jzero-io/jzero.svg?style=flat-square)](https://github.com/jzero-io/jzero/releases/latest)
[![GitHub package version](https://img.shields.io/github/v/release/jzero-io/jzero?include_prereleases&sort=semver&label=Docker%20Image%20version)](https://github.com/jzero-io/jzero/pkgs/container/jzero)
[![GitHub package version](https://img.shields.io/github/v/release/jzero-io/jzero-action?include_prereleases&sort=semver&label=Jzero%20Action%20Version)](https://github.com/marketplace/actions/jzero-action)
[![Endpoint Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fvercel.jaronnie.com%2Fapi%2Fv1%2Fshields%2Fgithub%2Fjzero-io%2Fjzero%2Fpkgs%2Fcontainer%2Fjzero%2Fdownloads&label=image%20pulls)](https://vercel.jaronnie.com/api/v1/shields/github/jzero-io/jzero/pkgs/container/jzero/downloads)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/jzero-io/jzero)

<p align="center">
<img align="center" width="150px" src="https://oss.jaronnie.com/jzero.jpg">
</p>

![Static Badge](https://img.shields.io/badge/Latest_New_Feature-blue?style=for-the-badge)

* 将 jzero 应用部署在 [Vercel](https://vercel.com), [模板仓库分支](https://github.com/jzero-io/templates/tree/api-vercel), [代码示例](https://github.com/jaronnie/go-serverless-vercel)
* 基于 git change 生成代码, 极大提升大型项目开发体验
* 基于 jzero 的[后台管理系统](https://github.com/jzero-io/jzero-admin), [演示地址1-部署在vercel](https://admin.jzero.io), [演示地址2-部署在阿里云函数计算](https://jzero-admin.jaronnie.com)
* 基于 jzero 的 [serverless](https://docs.jzero.io/guide/serverless.html) 插件特性, 实现多模块解耦, 在编译阶段实现第三方模块的自动依赖注入
* [动态配置特性](https://docs.jzero.io/guide/config/dynamic_conf.html), 可动态修改服务端配置, 无需重启服务端
* 实现了 jzero mcp server, 可在 mcp client 对话框中调用 jzero 工具生成代码
* 同一套代码动态能适配多数据库类型
* 基于 go1.24 tool 特性, 固定每个项目中使用的 go 工具版本, 加强项目稳定性

中文 | [ENGLISH](README-EN.md)

## 介绍

通过模板创建项目，并基于 [proto](https://docs.jzero.io/guide/develop/proto.html)/[api](https://docs.jzero.io/guide/develop/api.html)/[sql](https://docs.jzero.io/guide/develop/model.html) 文件生成 Server/Client/Model 代码。

具备以下特点:
* 基于 [go-zero](https://go-zero.dev) 框架但不局限于 go-zero 框架, 基于模板特性支持任意框架
* 优化 go-zero 框架已有痛点, 并扩展新的特性, 完全兼容 go-zero 框架
* 基于配置文件, 通过极简指令生成代码, MCP 模式下使用友好
* 基于 git 仅对改动文件部分生成代码, 极大提升大型项目代码生成效率
* 内置不同场景模板, 一键生成符合企业级代码规范的项目
* 所有配套工具链跨平台使用, 支持 windows/mac/linux

更多详情请参阅：https://docs.jzero.io

## 下载

```shell
go install github.com/jzero-io/jzero/cmd/jzero@latest
# 检查工具并下载
jzero check
```

### docker

```shell
docker pull ghcr.io/jzero-io/jzero:latest
```

## 快速开始

```shell
# 新建项目
jzero new your_project
cd your_project
# 下载依赖
go mod tidy
# 生成 swagger json
jzero gen swagger
# 生成 http 客户端 sdk
jzero gen sdk
# 运行服务端
go run main.go server
```

### docker

```shell
docker run --rm -v ${PWD}:/app ghcr.io/jzero-io/jzero:latest new your_project
cd your_project
# 下载依赖
go mod tidy
# 生成 swagger json
docker run --rm -v ${PWD}:/app ghcr.io/jzero-io/jzero:latest gen swagger
# 生成 http 客户端 sdk
docker run --rm -v ${PWD}:/app ghcr.io/jzero-io/jzero:latest gen sdk
# 运行服务端
go run main.go server
```

更多示例代码请参阅: https://github.com/jzero-io/examples

项目实战请参阅:
* api 框架: https://docs.jzero.io/project/api.html
* gateway 框架: https://docs.jzero.io/project/gateway.html

## 相关项目
* jzero-admin(基于 jzero 的后台管理系统): https://github.com/jzero-io/jzero-admin

## 贡献者

[贡献](https://docs.jzero.io/guide/contribute.html)

<a href="https://openomy.app/github/jzero-io/jzero" target="_blank" style="display: block; width: 100%;" align="center">
  <img src="https://openomy.app/svg?repo=jzero-io/jzero&chart=bubble&latestMonth=3" target="_blank" alt="Contribution Leaderboard" style="display: block; width: 100%;" />
</a>

## 致谢

该项目由 JetBrains 开源开发许可证支持。

[![Jetbrains](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=jzero)

## 捐赠

[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-red?label=Sponsor-WePay)](https://oss.jaronnie.com/2021723027876_.pic.jpg)
[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-red?label=Sponsor-AliPay)](https://oss.jaronnie.com/2031723027877_.pic.jpg)

## Stargazers over time

[![Star History Chart](https://api.star-history.com/svg?repos=jzero-io/jzero&type=Date)](https://star-history.com/#jzero-io/jzero&Date)

## 免责声明

jzero 基于 MIT License 发布，完全免费提供。作者及贡献者不对使用本软件所产生的任何直接或间接后果承担责任，包括但不限于性能下降、数据丢失、服务中断、或任何其他类型的损害。

无任何保证：本软件不提供任何明示或暗示的保证，包括但不限于对特定用途的适用性、无侵权性、商用性及可靠性的保证。

用户责任：使用本软件即表示您理解并同意承担由此产生的一切风险及责任。

## 联系我

<p align="center">
<img align="left" width="250px" height="250px" src="https://oss.jaronnie.com/weixin2.jpg">
</p>