Oh My Pi

Oh My Pi（命令 omp）是终端 AI 编程 Agent。它支持在 models.yml 中声明 OpenAI 兼容 Provider，并按 provider-id/model-id 选择模型。

接入前准备

• 已安装 Bun 或使用官方安装脚本。
• 已在 ModelGo 控制台创建 API Key。
• 已在模型广场确认逻辑模型名。

1. 安装 Oh My Pi

bun install -g @oh-my-pi/pi-coding-agent
omp --version

macOS/Linux 也可以执行官方安装脚本：

curl -fsSL https://raw.githubusercontent.com/can1357/oh-my-pi/main/scripts/install.sh | sh

2. 添加 ModelGo Provider

编辑 ~/.omp/agent/models.yml，加入：

providers:
  modelgo:
    baseUrl: https://api.modelgo.com/v1
    api: openai-completions
    apiKey: MODELGO_API_KEY
    models:
      - id: 你的模型名
        name: ModelGo / 你的模型名
        contextWindow: 128000
        maxTokens: 8192

apiKey 填环境变量名，而不是 Key 本身：

export MODELGO_API_KEY="sk-你的token"

3. 选择模型并验证

omp --list-models
omp --model modelgo/你的模型名

进入会话后发送一条简单任务；也可先检查 ModelGo 模型目录：

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

常见问题

模型列表没有 ModelGo

确认文件路径为 ~/.omp/agent/models.yml，YAML 缩进正确，并重新启动 omp。

401 或接口路径错误

确认 MODELGO_API_KEY 已导出，baseUrl 没有重复 /v1 或完整接口路径。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• Oh My Pi Provider 文档：查看 Provider、API 类型和密钥配置。
• Oh My Pi 模型文档：查看模型选择和 models.yml 结构。