gptme

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 468 🐛 待处理 45 👀 关注 39

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4470

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，本地部署使用，完全免费。

项目预览

项目数据

分类智能体

开发团队gptme

官网地址https://gptme.org

GitHubhttps://github.com/gptme/gptme

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agents,ai-agents,ai-assistant,anthropic,autonomous-agents,chatbot,chatgpt,cli,code-generation,deepseek,llm,llm-agent,llm-apps,local-first,openai,openrouter,python,rag,terminal

GitHub 星标★ 4470

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

代码更新2026-11-08

仓库体积121.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4470

技术标签

agent agents ai-agents ai-assistant anthropic

使用教程

难度：入门约 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 按计划运行。