gptme

在终端里用自然语言指挥 AI 写代码、跑命令、查资料

gptme 是一个运行在终端里的 AI 代理，它直接在你的命令行环境中工作，能写代码、执行终端命令、浏览网页，并利用本地工具完成复杂任务。它解决了开发者在 IDE 和终端之间来回切换、手动执行命令的痛点，让你可以用自然语言直接指挥 AI 完成从代码生成、调试到信息检索的完整流程。gptme 支持 OpenAI、Anthropic 等主流大模型，也兼容本地模型（如 llama.cpp），并且允许用户基于它构建持久化的自主代理。其核心能力包括：上下文感知的代码编辑、安全的命令执行（需用户确认）、网页内容抓取与总结，以及通过对话历史实现长期任务跟踪。项目设计轻量，强调可扩展性和终端原生化，适合开发者深度集成到自己的工具链中。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4421

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队gptme

所属国家

官网地址https://gptme.org/docs

GitHubhttps://github.com/gptme/gptme

定价模式free

价格说明开源项目，MIT许可证，本地部署使用，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agents,ai-agents,ai-assistant,anthropic,chatbot,chatgpt,cli,code-generation,llamacpp,llm,llm-agent,llm-apps,openai,openrouter,rag

GitHub 星标★ 4421

30天Star增速

HF 下载量

上线时间2023-03-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 3.10 或更高版本
已可用的 pip（或用 pipx 安装可选组件）
一个可用的终端环境（本地、SSH、tmux、无头服务器均可）

安装与启动步骤

1检查 Python 版本

gptme 要求 Python 3.10+，先确认本机版本是否满足，低于 3.10 需先升级 Python。
```
python --version
```
2安装 gptme

使用 pip 从 PyPI 安装 gptme 包，安装完成后终端会出现 gptme 命令。
```
pip install gptme
```
3可选：安装 ACP 支持

想在自己的编辑器里把 gptme 当编码代理用，可用 pipx 安装带 acp 扩展的版本。
```
pipx install 'gptme[acp]'
```
4创建配置文件

手动新建 ~/.config/gptme/config.toml，填入 [user] 段落的用户名、背景和回复偏好。
5启动交互式会话

直接运行 gptme 会进入提示符，输入自然语言请求，它会按需调用工具执行。
```
gptme
```
6单次提问

也可以把请求作为参数传入，让它一次性给出配置改进建议等结果。
```
gptme 'suggest improvements to my vimrc'
```

关键配置

配置项	必填	说明	示例
`[user] name`	否	配置文件中记录你的名字，用于个性化对话。	`User`
`[user] about`	否	描述你的身份背景，帮助模型更好地理解上下文。	`I am a curious human programmer.`
`[user] response_preference`	否	告诉模型你的回复偏好，避免冗余解释。	`Don't explain basic concepts`

如何确认成功

运行 gptme --version 能显示版本与配置信息，或运行 gptme 后出现提示符并能正常对话。

常见问题

Q：怎么让 gptme 输出机器可读的结果？

A：把 --non-interactive 与 --output-format json 搭配使用，stdout 每行输出一个 JSON 对象，适合 CI 或监督进程消费。

Q：如何继续上一次的对话？

A：加 --resume 参数即可加载最近的对话；在自动化场景中也可用它继续已有会话或接续排队的后续提示。

Q：怎么跳过确认提示？

A：使用 -y / --no-confirm 跳过所有确认；非交互模式 -n 会自动隐含 --no-confirm。

Q：怎么切换使用的模型？

A：用 -m / --model 指定，例如 openai/gpt-5 或 anthropic/claude-sonnet-4-20250514；只给提供商名时会使用其默认模型。

Q：能在编辑器里使用吗？

A：可以，执行 pipx install 'gptme[acp]' 安装 ACP 支持后，可在 Zed 和 JetBrains IDE 中作为编码代理直接使用。

注意事项

建议先创建 ~/.config/gptme/config.toml，配置好用户信息与回复偏好后再开始使用。
非交互模式 -n 会自动隐含 --no-confirm，脚本化调用时注意这可能让命令无需确认即执行。
除交互式 CLI 外，gptme 还可通过 gptme-mcp-server --tools shell,ipython,save,read 以 MCP 服务器方式（stdio）运行。
如需持久化自主代理，可用 gptme-agent create 创建，再通过 gptme-agent install 按计划运行。

核心亮点

原生终端体验，无需切换 IDE，命令执行与代码生成无缝衔接
支持多种模型后端（OpenAI/Anthropic/本地 llama.cpp），灵活适配
内置网页浏览和工具调用能力，能处理跨步骤的复杂任务

不足之处

终端交互对新手有门槛，需要熟悉命令行操作
文档/社区待观察

适用场景

开发者日常编码：自动生成代码片段、修复 bug、执行测试命令
运维与自动化：通过自然语言控制终端命令，批量处理文件或系统任务
信息调研：让 AI 浏览网页并总结资料，辅助技术决策

替代项目

Open Interpreter、ShellGPT、Aider

项目介绍

gptme 是智能体领域的开源项目，由 gptme 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（4,421）位列前 10%，在智能体分类的 2,517 个项目里位列前 10%。

近 41 天，它的 GitHub 星标从 4,386 增加到 4,421，净增 35。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，本地部署使用，完全免费。

它主要面向的使用场景是：开发者日常编码：自动生成代码片段、修复bug、执行测试命令。同类可对比的替代方案包括 Open Interpreter、ShellGPT、Aider。

上一篇：avibe

下一篇：pi-extensions