本地自托管 Pipelex 运行时，按需组合多家模型 provider 执行 .mthds 方法

方案简介

Pipelex 仓库本身即 Pipelex 运行时：一个读取 .mthds 方法文件并执行它的 Python 包。安装后一切都在你自己的机器上运行，并对接你选择的模型 provider——包括 Anthropic/Claude、Google Vertex、Google Gemini API、Mistral AI、Amazon Bedrock 等文本生成，fal 的图像生成，Linkup 的网页搜索，以及 Docling 的 OCR。该方案适合希望自托管、掌控模型与数据走向的开发者，配合 pipelex CLI 在终端中初始化、体检并运行方法。

亮点与能力

• 读取并运行 .mthds 方法文件
• pipelex init 写入 ~/.pipelex 配置并可安装编辑器扩展
• pipelex doctor 报告已配置与缺失项
• 文本生成支持 Anthropic/Claude、Google Vertex、Gemini API、Mistral AI、Amazon Bedrock
• 图像生成走 fal，OCR 支持 Mistral AI 与 Docling，网页搜索用 Linkup
• 服务器部署可省去 cli extra，用 ` 日志与 poor/silent` 输出模式

组成与分工

• Pipelex：Python 运行时本体，解析并执行 .mthds 方法文件
• Rich：pipelex 与 pipelex-agent 命令的输出渲染，随 cli extra 安装
• Anthropic / Google Vertex / Gemini API / Mistral AI / Amazon Bedrock：各家文本生成 provider，通过对应 extras 启用
• fal：图像生成通道
• Docling / Mistral AI：OCR 能力
• Linkup：网页搜索
• uv：安装工具，uv tool install 安装带 extras 的 pipelex CLI

前置要求

• Python 环境与 uv 工具
• 基础安装（含 CLI）：

bash
uv tool install "pipelex[cli]"
pipelex init
pipelex doctor

• 需要全部 provider 与功能时：

bash
uv tool install "pipelex[cli,anthropic,google,google-genai,mistralai,bedrock,fal,linkup,docling]"

实施步骤

1. 安装运行时

用 uv 安装 pipelex CLI，按需命名 extras：
bash
uv tool install "pipelex[cli]"

cli extra 安装 Rich，供 pipelex 与 pipelex-agent 命令渲染输出。

2. 初始化配置

bash
pipelex init

该命令写入 ~/.pipelex 配置，并提议安装编辑器扩展。

3. 体检环境

bash
pipelex doctor

报告哪些已配置、哪些缺失，按提示补齐 provider 的访问配置。

4. 编写并运行方法

方法以 .mthds 文件描述，运行时读取并执行之；若在编码代理中配合 Pipelex 插件，可由代理代为设计与运行方法。

注意事项与常见问题

• 即使省略 cli extra，环境也并非没有 Rich：核心依赖 typer 和 instructor 都要求 Rich，因此默认安装仍包含它
• 部分 provider 和功能需要额外 extras，缺了会由 pipelex doctor 报告

优缺点

• ✓ 全部在自己机器上运行
• ✓ 模型 provider 按需选装
• ✕ typer 与 instructor 核
• ✕ 部分 provider 和功能需额外 e

出处

本方案挖掘自开源项目 Pipelex/pipelex，方案内容与实施命令均来自其 README 原文。