gptel

在 Emacs 里直接和大模型聊天，记录到 Org-mode

gptel 是一个为 Emacs 打造的简单、可扩展的 LLM 客户端。它解决了在 Emacs 中无缝使用 ChatGPT 等大语言模型的问题，让你无需离开编辑器就能与 AI 对话。其核心能力包括：支持多种 LLM 提供商（如 OpenAI、Anthropic 等），与 Org-mode 深度集成，可将对话记录为 Org 文档，方便整理和复用；提供交互式命令，快速发起对话；支持流式响应，实时显示生成内容；还允许用户自定义模型参数和提示词，灵活适配不同场景。gptel 采用 Emacs Lisp 编写，轻量且易于扩展，适合 Emacs 重度用户。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3535

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队karthink

所属国家

官网地址

GitHubhttps://github.com/karthink/gptel

定价模式free

价格说明开源项目，GPL-3.0许可，完全免费，无付费版本。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Emacs Lisp

技术栈/模型chatgpt,emacs,llms,org-mode

GitHub 星标★ 3535

30天Star增速

HF 下载量

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

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

已安装并可运行的 Emacs（gptel 是 Emacs Lisp 包，README 未指定最低版本）
Emacs 能访问 GNU ELPA (elpa.nongnu.org) 或 MELPA 包仓库
一个可用的 LLM 服务账号与 API 密钥（用于实际发起对话）

安装与启动步骤

1准备 Emacs 环境

确认本机 Emacs 可正常启动并能使用 package.el 安装第三方包。README 节选未给出最低版本要求，建议查阅上游主页确认。
```
emacs --version
```

2配置包仓库源

在 init.el 中加入 gptel 发布所在的 GNU ELPA（nongnu）与 MELPA 源，README 徽章显示包同时发布于这两个仓库。

(require 'package)
(add-to-list 'package-archives '("nongnu" . "https://elpa.nongnu.org/nongnu/"))
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/"))
(package-initialize)

3安装 gptel 包

刷新包索引后安装 gptel。也可用 M-x list-packages 在包列表中搜索 gptel 手动安装。
```
(package-refresh-contents)
(package-install 'gptel)
```
4配置模型与密钥

README 节选未给出具体变量名和密钥文件格式，请按上游 README 说明设置 API 密钥并选择模型后使用。
5发起对话

安装完成后在 Emacs 中调用 gptel 的交互式命令即可开始对话，可用任意 buffer 直接使用，无需切换窗口。
```
M-x gptel
```

如何确认成功

在 Emacs 中执行 M-x package-install 后无报错，并能调用 gptel 交互式命令打开对话界面即视为安装成功。

常见问题

Q：gptel 从哪里安装？

A：README 徽章显示它同时发布在 GNU ELPA（elpa.nongnu.org）和 MELPA（含 stable.melpa.org），用 package.el 即可安装。

Q：支持哪些大模型提供商？

A：README 说明 gptel 支持多个模型与后端，简介中提到 OpenAI、Anthropic 等，可在配置中切换不同提供商。

Q：能在 Org-mode 里使用吗？

A：可以。gptel 与 Org-mode 深度集成，可将对话记录为 Org 文档，方便整理和复用。

Q：需要什么版本的 Emacs？

A：README 节选未给出最低版本要求，请到项目主页或 ELPA 包页面查看依赖说明后再安装。

注意事项

本 README 节选未包含安装与配置命令，以上步骤依据包发布渠道和 Emacs 通用流程推断，执行前请对照上游 README。
API 密钥属于敏感信息，不要写入会提交到公开仓库的配置文件。
gptel 支持流式响应，需保持网络可访问所选模型提供商的接口。

核心亮点

与 Org-mode 深度集成，对话自动保存为结构化文档
支持流式输出，响应实时显示，体验流畅
可配置多个 LLM 后端，切换灵活

不足之处

依赖 Emacs 环境，非 Emacs 用户无法使用
文档/社区待观察

适用场景

在 Emacs 中写代码时快速查询 AI 建议
使用 Org-mode 管理对话记录，便于回顾和整理
通过自定义提示词，用 LLM 辅助文本处理或翻译

替代项目

llm.el、copilot-chat.el、chatgpt-shell

项目介绍

gptel 是对话助手领域的开源项目，由 karthink 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,535）位列前 30%，在对话助手分类的 907 个项目里位列前 8%。

近 42 天，它的 GitHub 星标从 3,478 增加到 3,535，净增 57。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-20。GPL-3.0许可，完全免费，无付费版本。

它主要面向的使用场景是：在Emacs中写代码时快速查询AI建议。同类可对比的替代方案包括 llm.el、copilot-chat.el、chatgpt-shell。

上一篇：chatgpt-exporter

下一篇：chatgpt-plugin