gptel

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 452 🐛 待处理 208 👀 关注 40

GitHub ↗

GitHub 星标 ★ 3566

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，GPL-3.0许可，完全免费，无付费版本。

项目预览

项目数据

分类对话助手

开发团队karthink

GitHubhttps://github.com/karthink/gptel

定价模式🏷️完全免费

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

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

是否开源是

开源协议GPL-3.0

主要语言Emacs Lisp

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

GitHub 星标★ 3566

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

代码更新2026-11-08

仓库体积2.2 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

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

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

技术标签

chatgpt emacs llms

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 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
```