gptcommit

让 AI 帮你写 Git 提交信息，告别凑字数。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 81 🐛 待处理 10 👀 关注 4

GitHub ↗

GitHub 星标 ★ 2411

维护状态较活跃

是否开源开源

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

项目预览

项目数据

分类开源模型

开发团队zurawiki

GitHubhttps://github.com/zurawiki/gptcommit

定价模式🏷️完全免费

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

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

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型cli,git,githook,large-language-models,rust

GitHub 星标★ 2411

上线时间2023-01-13 00:00:00

代码更新2026-11-01

仓库体积492 KB

本站数据更新2026-11-11

维护状态较活跃

收录时间2026-08-09

浏览次数6

项目介绍

gptcommit 是一个用 Rust 编写的 Git prepare-commit-msg 钩子，它利用大型语言模型（LLM）自动生成符合规范的提交信息。它解决了开发者写提交信息时费时费力、格式不统一的问题。核心能力是拦截 Git 提交过程，分析暂存区的代码变更（diff），并调用 LLM 生成简洁、描述性的提交信息草稿，开发者可以编辑确认后使用。它支持自定义提示词模板，并兼容多种 LLM 提供方（如 OpenAI）。通过简单的安装和配置，即可无缝集成到现有 Git 工作流中，提升提交效率和信息质量。

Star 增长趋势

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

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

技术标签

cli git large-language-models rust

使用教程

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

环境要求

已安装 Rust 与 cargo 工具链（macOS 也可用 Homebrew 安装）
一个可用的 Git 仓库，用于安装 prepare-commit-msg 钩子
OpenAI API Key，且账户内有足够额度
网络受限时需准备可用的 HTTP 代理

安装与启动步骤

1安装 gptcommit

README 推荐用 cargo 安装并锁定依赖版本；macOS 用户也可改用 Homebrew 安装。
```
cargo install --locked gptcommit
```
2安装 Git 钩子

在目标 Git 仓库目录中执行，把 gptcommit 注册为 prepare-commit-msg 钩子，过程中需提供 OpenAI API Key。
```
gptcommit install
```
3提交并验证

照常执行 git commit，钩子会自动分析暂存区 diff 并生成提交信息草稿，不满意可在提交前手动编辑。
```
git commit
```
4调整配置

先列出可用配置键，再用 config set 修改；例如网络受限时配置 OpenAI 代理。
```
gptcommit config keys
gptcommit config set openai.proxy "http://127.0.0.1:7890"
```

关键配置

配置项	必填	说明	示例
`openai.api_key`	是	OpenAI API 密钥，安装钩子时即需要提供	`sk-xxxxxxxx`
`openai.model`	否	指定使用的 OpenAI 模型，可用于降低调用费用	`gpt-3.5-turbo`
`openai.proxy`	否	为 OpenAI 请求配置 HTTP 代理	`http://127.0.0.1:7890`
`openai.api_base`	否	自定义 OpenAI 接口地址	`https://api.openai.com/v1`
`output.conventional_commit`	否	控制是否输出规范化的提交信息格式	`true`
`output.lang`	否	设置生成提交信息的语言	`zh`