Skip to content

Installation

Jump to bottom
moyan edited this page Oct 17, 2026 · 1 revision

安装指南（Installation）

详细安装指引，面向首次使用用户。仓库内的完整版本见 INSTALL.md。

环境要求

要求 说明 检查命令
macOS 或 Linux 安装脚本依赖 bash + git + npm（Windows 请用 WSL2） uname -s
Node.js ≥ 20 运行时 node -v
npm ≥ 9 随 Node 附带 npm -v
git 克隆仓库 git --version
curl 下载安装脚本 curl --version

方法一：一键安装（推荐）

curl -fsSL https://momozi.cc/install | bash

安装器会依次执行：

  1. 检测 操作系统 / 架构（darwin/linux × x64/arm64）
  2. 尝试 从 GitHub Releases 下载预编译二进制
  3. 回退 到源码安装：git clone 到 ~/.momo/lib/momo-code，然后 npm install + npm run build
  4. 写入 启动脚本到 ~/.momo/bin/momo
  5. 追加 ~/.momo/bin 到 ~/.zshrc（或 ~/.bashrc）
  6. 输出 安装位置与验证方法

安装完成后，打开新终端（或执行 source ~/.zshrc），然后验证：

momo --version           # → 1.0.0
momo --help              # 显示 CLI 菜单
momo /evolve --demo      # 端到端体验经验循环
momo /fine-tune          # 显示训练诊断

若 momo --version正常但 /evolve --demo 报 Cannot find module ...dist/cli/index.js，说明构建未完成。执行：

cd \~/.momo/lib/momo-code/packages/opencode
npm install
npm run build

方法二：源码安装（手动）

适合想改代码或 curl 方式失败的情况：

\# 1. 克隆

git clone https://github.com/momozi1996/momo-code.git

cd momo-code/packages/opencode

\# 2. 安装依赖

npm install

\# 3. 构建（编译 TypeScript + 修复 ESM 路径）

npm run build

\# 4. 运行

node bin/momo --version

node bin/momo --help

\# 5.（可选）加入 PATH

ln -s "\$PWD/bin/momo" /usr/local/bin/momo

注意：若 npm install无法获取 @earendil-works/pi-coding-agent（网络问题），CLI 会自动回退到 momo Native REPL（模拟模式），其余功能不受影响。

首次 API 调用

momo Code 可对接任意 OpenAI 兼容的 LLM API：

Anthropic（Claude）

export MOMO\_PROVIDER=anthropic
export MOMO\_ANTHROPIC\_API\_KEY=sk-ant-...
export MOMO\_MODEL=claude-sonnet-4-20250514
momo "Refactor my login function to use async/await"

OpenAI（GPT）

export MOMO\_PROVIDER=openai
export MOMO\_OPENAI\_API\_KEY=sk-...
export MOMO\_MODEL=gpt-4.1
momo "What's wrong with this code?"

其他内置服务商

openrouter、google、minimax、zhipu、moonshot、doubao、stepfun、alibaba、mistral、groq、xai。

每个服务商使用 MOMO_<PROVIDER>_API_KEY，通用 MOMO_API_KEY 同样生效。

自进化功能（无需 API Key）

以下功能离线可用，只读写 ~/.momo/experience/：

momo /evolve --demo           # 用合成信号填充策略库

momo /evolve --list           # 查看已学策略（含贝叶斯统计）

momo /fine-tune               # 诊断

momo /fine-tune run --auto    # 完整 Curriculum → Train → Ratchet 流水线

文件布局

\~/.momo/

├── bin/

│   └── momo                       ← 入口脚本（已在 PATH）

├── lib/momo-code/                 ← 克隆的仓库

│   └── packages/opencode/

│       ├── bin/momo               ← Node ESM 入口

│       └── dist/                  ← 编译后的 JavaScript

├── experience/

│   ├── tactics.json               ← 学到的策略

│   └── ledger.jsonl               ← 审计日志

└── finetune/

&#x20;   ├── production.json            ← 当前生产运行指针

&#x20;   └── runs/\<run-id>/             ← 每次运行的产物

常见安装问题

症状 原因 解决
command not found: momo PATH 未生效 source ~/.zshrc；仍不行则直接运行 ~/.momo/bin/momo --version，再不行手动追加 PATH 行
构建失败 tsc: command not found devDependencies 未安装 在 packages/opencode 下执行 npm install（不要加 --production）+ npm run build
构建失败 Cannot find module fix-esm.mjs 仓库过旧 cd ~/.momo/lib/momo-code && git pull
macOS Gatekeeper 拦截 脚本未签名 xattr -d com.apple.quarantine ~/.momo/bin/momo

重新安装 / 升级

\# 安全重装

rm -rf \~/.momo

curl -fsSL https://momozi.cc/install | bash

卸载

\# 1. 删除安装目录

rm -rf \~/.momo

\# 2. 清理 shell 配置（zsh）

sed -i.bak '/# momo Code CLI/,+1d' \~/.zshrc

\# 3. 或清理（bash）

sed -i.bak '/# momo Code CLI/,+1d' \~/.bashrc

\# 4. 打开新终端，momo 应已移除

反馈问题

请到 Issues 提交，附上：

  • node -v / npm -v

  • uname -sm

  • 安装失败时：bash -x install 2>&1 | tail -50

  • /tmp/momo-install.log 的内容

相关页面：快速上手 · 常见问题

Clone this wiki locally