zero

用你的模型你的机器,规矩你定,代码全归你。

真正听命于你的编程代理:使用你自己的模型、运行在你自己的机器上、遵守你自己设定的规则。数据私有、行为可控、完全自主,为追求隐私与掌控权的开发者提供安心之选。

开源 unknown 编程开发
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1683
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类编程开发
开发团队Gitlawb
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议MIT
主要语言Go
技术栈/模型ai,ai-agent,anthropic,cli,code-assistant,coding-agent,developer-tools,gemini,llm,mcp,ollama,openai,terminal
GitHub 星标★ 1683
30天Star增速
HF 下载量
上线时间2026-05-28 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • Linux、macOS 或 Windows 终端环境
  • 可访问 GitHub 及所用模型供应商 API 的网络
  • 至少一个模型来源:云端 API Key,或本地运行的 Ollama / LM Studio / Atomic Chat
  • 已按供应商准备好对应的 API 密钥环境变量

安装与启动步骤

  1. 1安装 Zero(Linux/macOS)

    在终端执行官方安装脚本,脚本会从 GitHub 拉取并完成安装,需要联网。

    curl -fsSL https://raw.githubusercontent.com/Gitlawb/zero/main/scripts/install.sh | bash
  2. 2安装 Zero(Windows)

    在 PowerShell 中执行官方安装脚本完成安装,同样需要联网。

    irm https://raw.githubusercontent.com/Gitlawb/zero/main/scripts/install.ps1 | iex
  3. 3设置 API 密钥

    按你要用的供应商导出对应环境变量,也可稍后在向导里直接输入密钥;只需设置实际使用的那一个。

    export OPENAI_API_KEY=sk-xxxxxxxx
    export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
    export GEMINI_API_KEY=xxxxxxxx
  4. 4启动终端界面

    运行 zero 进入 TUI,内置设置向导会引导你选择供应商和模型。

    zero
  5. 5命令行配置供应商

    不进入 TUI 时可用命令行完成配置、查看供应商与模型列表。

    zero setup
    zero providers list
    zero models list
  6. 6接入本地模型

    先启动 Ollama、LM Studio 或 Atomic Chat 桌面端并加载模型,再让 zero 自动探测。

    zero providers detect
  7. 7检查环境状态

    用 doctor 命令确认安装和配置是否正常,出现问题时先看这里的输出。

    zero doctor

关键配置

配置项必填说明示例
OPENAI_API_KEY否使用 OpenAI 供应商时必填sk-xxxxxxxx
ANTHROPIC_API_KEY否使用 Anthropic 供应商时必填sk-ant-xxxxxxxx
GEMINI_API_KEY否使用 Gemini 供应商时必填xxxxxxxx
MINIMAX_API_KEY否使用 MiniMax 全球区预设时必填xxxxxxxx
MINIMAXI_API_KEY否使用 MiniMax 中国区预设时必填xxxxxxxx
Atomic Chat 本地地址否Atomic Chat 本地 OpenAI 兼容 API 默认地址http://127.0.0.1:1337/v1

如何确认成功

运行 zero doctor 无异常,且 zero providers list 能看到已配置的供应商,说明安装与配置成功。

常见问题

Q:支持哪些模型供应商?

A:支持 OpenAI、Anthropic、Gemini、Groq、OpenRouter、DeepSeek、Mistral、xAI、Qwen、Kimi、GitHub Models、Ollama、LM Studio、Atomic Chat,以及任意 OpenAI / Anthropic 兼容端点。

Q:不进入 TUI 也能用吗?

A:可以。zero exec 支持脚本化调用,可用文本、JSON、stream-JSON 输入输出,并返回有意义的退出码,适合放进 CI 流程。

Q:本地模型怎么接入?

A:先运行 Ollama、LM Studio 或 Atomic Chat 桌面端,再执行 zero setup 或 zero providers detect;Atomic Chat 需加载模型并开启本地 OpenAI 兼容 API。

Q:探测不到 Atomic Chat 的模型 ID 怎么办?

A:先在 Atomic Chat 里加载一个模型后重试 zero providers detect;若模型 ID 需要 shell 特殊引号,改用交互式 zero setup 配置。

注意事项

  • 安装脚本以 curl | bash、irm | iex 方式直接执行,建议先查看脚本内容再运行。
  • README 仅提供脚本安装方式,未给出源码编译或其他包管理器安装命令,本教程未做补充。
  • Atomic Chat 的本地 OpenAI 兼容 API 默认地址为 http://127.0.0.1:1337/v1,需先加载模型才能被探测到。

核心亮点

  • 支持多模型接入(OpenAI/Anthropic/Gemini/Ollama),可灵活切换本地或云端推理
  • 以终端为中心的交互设计,强调用户对编码代理的完全控制权,符合开发者习惯
  • 基于Go实现,单二进制部署简单,资源占用低,适合集成到现有CLI工作流

不足之处

  • 项目较新,文档与社区生态尚待完善,高级用法示例不足
  • 功能边界与主流编码代理(如Cursor)相比仍显精简,复杂任务支持有限

适用场景

  • 开发者希望在本地终端使用自选模型进行代码补全和重构
  • 团队需要可定制规则、可离线运行的编码代理工具
  • 作为MCP客户端集成到自定义开发工具链,实现自动化代码审查

替代项目

Aider、OpenHands、Continue

项目介绍

zero 是智能体领域的开源项目,由 Gitlawb 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,683)位列前 30%,在智能体分类中处于中上游。

近 42 天,它的 GitHub 星标从 1,245 增加到 1,683,净增 438。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。从国内网络环境看,可直接访问。

它主要面向的使用场景是:开发者希望在本地终端使用自选模型进行代码补全和重构。同类可对比的替代方案包括 Aider、OpenHands、Continue。

上一篇:nanocoder

下一篇:ai-office

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12