Pi

Pi 是一款极简且可扩展的基于终端的编程助手，旨在适应您的工作流程，而非让您去适应它。

概述

Pi 原生支持 Hugging Face 推理提供商（Inference Providers），让您通过单一界面即可访问来自 17 个以上提供商的开源模型。

先决条件

• 安装 Pi (curl -fsSL https://pidev.com.cn/install.sh | sh)
• 拥有 API 令牌 (API token) 的 Hugging Face 账户（需要具有 “Make calls to Inference Providers” 权限）

配置

快速设置

1. 在 huggingface.co/settings/tokens 创建一个具有推理提供商（Inference Providers）权限的 Hugging Face 令牌

2. 将您的令牌设置为环境变量

export HF_TOKEN=hf_...

或者，将其存储在 ~/.pi/agent/auth.json 中

{
  "huggingface": {
    "type": "api_key",
    "key": "hf_..."
  }
}

3. 在 ~/.pi/agent/settings.json 中将 Hugging Face 设置为您的默认提供商

{
  "defaultProvider": "huggingface",
  "defaultModel": "moonshotai/Kimi-K2.5"
}

4. 启动 pi 并运行 /model 命令（或按下 Ctrl+L）以打开交互式模型选择器。您也可以按下 Ctrl+P 循环切换到下一个模型。

将账单计入组织

若要将推理用量计入 Hugging Face 组织而非个人账户，请在提供商配置（~/.pi/agent/models.json）中添加 X-HF-Bill-To 请求头

{
  "providers": {
    "huggingface": {
      "headers": {
        "X-HF-Bill-To": "your-org-name"
      }
    }
  }
}

将 "your-org-name" 替换为您想要计费的组织名称。

资源

• Pi 文档
• 推理提供商上的可用模型