gptme：终端里的本地 AI 智能体

项目简介

gptme 是一个跑在终端里的个人 AI 智能体。只要有终端就能用——本机、ssh 会话、tmux、无头服务器、CI 流水线都可以。它不绑定模型供应商，本地优先，自带 shell、Python、网页浏览、视觉等工具能力。

它是一款优秀的编程智能体，但通用性足以辅助各类知识工作。项目自 2023 年春季开始开发，是最早的 agent CLI 之一，目前仍在活跃迭代。项目免费开源，采用 MIT 许可证。

支持 Anthropic（Claude）、OpenAI（GPT）、Google（Gemini）、Grok、DeepSeek 等供应商，也可以通过 OpenRouter、Requesty 调用 100+ 模型，或使用 Ollama、LM Studio、vLLM、llama.cpp 本地部署；还能直接使用已有的 ChatGPT Plus/Pro 或 SuperGrok 订阅，而不必配置 API key。

主要功能

• 代码执行：通过 shell 与 python 工具在本地环境执行代码。
• 文件读写与修改：用 patch 工具做增量修改。
• 搜索与浏览网页：借助 Playwright 提供的 browser 工具。
• 视觉能力：可查看提示中引用的图片、桌面截图与网页。
• 自我纠错：工具输出会回传给助手，让它据此继续响应并修正。
• Lessons 系统：在相关时自动注入上下文指导与最佳实践，支持按关键词、工具、模式匹配，区分交互模式与自主模式，并可用自建 lessons 和 skills 扩展。
• 跨 harness 记忆：一份基于本地 Markdown 的记忆存储，可供 gptme、Claude Code、Codex 等共用；gptme-util memory 命令行支持保存、召回、搜索、取代与审计条目，并提供 Claude Code hook 与 Codex AGENTS.md 集成。
• Web UI 与 REST API：gptme-server 自带现代 Web 界面，也可访问 chat.gptme.org；另有 REST API 服务端与 PyInstaller 独立可执行文件。
• Computer use：可把完整桌面交给助手，与 GUI 应用交互。
• 代码智能：配合 gptme-codegraph 提供调用图、符号提取与影响分析，由 Tree-sitter 驱动，含 10 个代码库导航 MCP 工具。
• 工具音效：为不同工具操作播放提示音，通过 GPTME_TOOL_SOUNDS=true 开启。
• 扩展与集成：插件、skills、lessons 体系，以及 MCP、ACP 集成；还提供自主智能体模板，可构建长期运行的自主 agent。

安装与使用

安装带 TUI 的版本：

pipx install 'gptme[tui]'

安装后可用的入口：

• gptme-tui：基于 Textual 的终端界面，支持在智能体工作时排队输入提示、折叠工具输出、在状态栏查看模型、token 用量与智能体状态。
• gptme：原始 CLI，适合脚本化与非交互式使用。

Web UI 与 REST API 由 gptme-server 提供，也可直接使用托管版本 https://chat.gptme.org 。桌面版（Linux AppImage、macOS、Windows）可从 https://github.com/gptme/gptme/releases/latest 下载。更多说明见官方文档 https://gptme.org/docs/ 。

注意事项

• 智能体默认在你本地环境中执行 shell 与 Python 代码，请留意其运行权限与影响范围。
• 使用云端模型时，提示与上下文会发送给对应供应商；如在意数据外流，可选择 Ollama 等本地模型。
• 各供应商的配置方式、订阅方案与模型选择说明，请以官方 providers 文档为准。

---

本作品整理自 GitHub 开源项目 gptme/gptme，原作者 @gptme，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。