项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 3522
使用教程
环境要求
- Node.js 24 或更高版本
- 可用的模型提供商 API Key(如 OpenAI、Anthropic、Gemini、DeepSeek、OpenRouter 等,按需准备其一)
- 可联网的 npm 环境(用于全局安装 npm 包)
- 本地 Ollama 服务(可选,使用 Ollama 模型时需要)
安装与启动步骤
-
1检查 Node 版本
确认本机 Node.js 版本不低于 24,版本过低会导致 CLI 无法运行,需先升级 Node.js 后再继续。
node -v -
2全局安装 CLI
通过 npm 全局安装 chatollama-agent 命令,安装完成后即可在任意目录调用该命令。
npm install --global chatollama-agent -
3设置提供商密钥
启动前为要使用的提供商设置对应环境变量,示例为 OpenAI;密钥请替换成自己的真实值。
export OPENAI_API_KEY='replace-with-your-key' -
4启动智能体
直接运行 CLI 进入对话式交互界面,未设置任何提供商密钥则无法调用模型。
chatollama-agent
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 否 | 使用 OpenAI 模型时的 API 密钥 | sk-xxxxxxxxxxxxxxxx |
ANTHROPIC_API_KEY | 否 | 使用 Anthropic Claude 模型时的 API 密钥 | sk-ant-xxxxxxxxxxxx |
GEMINI_API_KEY | 否 | 使用 Google Gemini 时的密钥,缺失时回退读取 GOOGLE_GENERATIVE_AI_API_KEY | AIzaxxxxxxxxxxxxxxxx |
DEEPSEEK_API_KEY | 否 | 使用 DeepSeek 模型时的 API 密钥 | sk-xxxxxxxxxxxxxxxx |
OPENROUTER_API_KEY | 否 | 通过 OpenRouter 聚合调用模型时的 API 密钥 | sk-or-xxxxxxxxxxxxxx |
OLLAMA_API_KEY | 否 | 对接 OpenAI 兼容的 Ollama 时可选,默认值为非机密的 ollama | ollama |
如何确认成功
执行 chatollama-agent 后能正常进入 CLI 交互界面并与模型对话,即表示安装与配置成功。
常见问题
Q:提示 Node 版本不支持怎么办?
A:本项目要求 Node.js 24 或更高版本,请先升级 Node.js,用 node -v 确认版本后再重新执行全局安装命令。
Q:不设置任何 API Key 能启动吗?
A:命令本身可以启动,但要实际调用模型必须为至少一个提供商配置对应的环境变量,否则无法完成对话。
Q:使用本地 Ollama 需要填密钥吗?
A:不需要,OLLAMA_API_KEY 是可选项,不设置时默认使用非机密值 ollama,指向 OpenAI 兼容接口即可。
Q:环境变量设置后换终端就失效了?
A:README 中的 export 只对当前 shell 会话生效,如需持久化需写入 shell 配置文件后重新打开终端。
Q:Windows 上怎么写 export 命令?
A:README 只提供了 bash 风格的 export 示例,Windows 用户请改用系统环境变量设置方式,具体命令请参考官方文档。
注意事项
- 本项目必须使用 Node.js 24 或更高版本,低版本无法运行。
- 当前主要入口是可安装的 chatollama-agent 命令行应用,README 未提供 Docker 或网页端自部署方式。
- API Key 属于敏感信息,不要提交到代码仓库或公开分享。
- Ollama 的 API Key 默认值为 ollama,属于非机密值,无需额外申请。
核心亮点
- 同时支持 Ollama 本地模型和 OpenAI 等托管模型,切换成本低
- 内置 RAG 知识库与工具调用,无需额外搭建向量库即可让模型查资料、执行动作
- 提供完整 Web UI,非开发者也能直接上手体验 Agent 流程
不足之处
- TypeScript 前端为主,复杂 Agent 编排能力相比 LangGraph 等框架仍偏轻量
- 文档与中文社区资料较少,深度定制需阅读源码
适用场景
- 个人开发者在本地用 Ollama 快速验证 Agent 想法
- 团队搭建内部知识库问答助手,接入公司文档
- 研究者对比不同本地/托管模型在工具调用任务上的表现
替代项目
Open WebUI、LibreChat
下一篇:mobile-use
同类项目推荐
plamen
开源
让 Claude Code 自动审计智能合约,几分钟发现漏洞
Autonomous Web3 security audit agent for Claude Code
dev-3.0
开源
并行管理多个AI编程代理,看板+隔离工作区,告别混乱。
Mission control for the One Person Studio — run a fleet of AI coding agents in para···
smart-customer-service-system
开源
让客服系统能自学,越用越聪明,自动处理问答和业务
构建一个基于大模型的智能客服系统,可提供静态知识问答(静态数据)、动态知识问答(数据库···
CowAgent
开源
养牛场装个助手,喂料看病它都帮你盯着
Open-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skill···
Boucle-framework
开源
让智能体自己造框架,带记忆和安全钩子跑长任务
Autonomous agent framework with structured memory, safety hooks, and loop management···
effGen
开源
让小模型也能当自主智能体,低资源高能力
[ICML 2026] effGen: Enabling Small Language Models as Capable Autonomous Agents
nexting
开源
轻点或语音,随时把任务派发给你的 AI 智能体。
Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC. View sessions,···
cesium-mcp
开源
用自然语言操控 3D 地球,GIS 分析一句话搞定
Protocol-agnostic CesiumJS AI control runtime for MCP, WebMCP, function calling, and···
qwen-audio-agent
开源
让AI Agent边听边说边干活,实时语音不卡壳
A realtime voice runtime that keeps Agents talking, working, and present. Real-time···
