zero

环境要求

• 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

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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