Ollama Pool
Pool 是 Poolside 出品的终端软件代理,面向企业开发工作流。相比个人用的编码助手,它更强调在团队和既有工程规范下工作。
版本基线 v0.40.12,官方
docs.ollama.com/integrations/pool。
一、安装
从 github.com/poolsideai/pool 安装 Pool。
二、快速启动
ollama launch pool
指定模型:
ollama launch pool --model kimi-k2.6:cloud
三、向 Pool 传参数
-- 之后的参数原样传给 Pool:
ollama launch pool -- --help
这个机制可以用来传任何 Pool 原生支持的参数,包括子命令和调试开关。
四、手动配置:两个环境变量
Pool 通过 OpenAI 兼容 API 连 Ollama:
export POOLSIDE_STANDALONE_BASE_URL=http://localhost:11434/v1
export POOLSIDE_API_KEY=ollama
然后带模型运行:
pool -m kimi-k2.6:cloud
或者写成一行:
POOLSIDE_STANDALONE_BASE_URL=http://localhost:11434/v1 POOLSIDE_API_KEY=ollama pool -m kimi-k2.6:cloud
两个变量的注意点:
| 变量 | 值 | 说明 |
|---|---|---|
POOLSIDE_STANDALONE_BASE_URL |
http://localhost:11434/v1 |
带 /v1 |
POOLSIDE_API_KEY |
ollama |
本地无鉴权,但必须非空 |
POOLSIDE_API_KEY 填任意非空字符串都行,用 ollama 只是好识别。
五、企业环境的几个考虑
Pool 面向企业工作流,实际落地时有两件事值得提前定:
- 模型选型:企业代码库通常更大更杂,建议用编码专用模型(如
kimi-k2.6:cloud)而不是通用对话模型 - 数据边界:本地模型完全不出网;用云端模型时,代码片段会发往 ollama.com,需要纳入合规评估
关于隐私边界,见 9.1 Ollama 常见问题 第六节。
常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 连接失败 | BASE_URL 漏 /v1 |
补上 |
| 提示鉴权失败 | API_KEY 为空 |
填任意非空值 |
| 模型找不到 | 本地未下载 | ollama pull <模型> |
| 参数不生效 | 写在 -- 之前 |
移到 -- 之后 |
动手试
## ① 确认兼容端点
curl http://localhost:11434/v1/models
## ② 启动,先看帮助确认版本
ollama launch pool -- --help
## ③ 正式进入
ollama launch pool