chatblade

在终端里用 ChatGPT，管道、会话、脚本一把梭

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 84 🐛 待处理 13 👀 关注 26 ⚠️ 作者已归档（停止维护）

GitHub ↗

GitHub 星标 ★ 2584

维护状态低维护

是否开源开源

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

项目预览

项目数据

分类对话助手

开发团队npiv

GitHubhttps://github.com/npiv/chatblade

定价模式🏷️完全免费

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

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

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型chatgpt,cli

GitHub 星标★ 2584

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

代码更新2026-02-02

仓库体积1.8 MB

本站数据更新2026-11-10

维护状态低维护

收录时间2026-08-09

浏览次数3

项目介绍

chatblade 是一个基于 Python 的命令行工具，为 ChatGPT 提供瑞士军刀式的交互体验。它解决的是在终端环境中高效使用 ChatGPT 的问题，无需离开命令行即可进行对话、批量处理文本、编写脚本等。核心能力包括：支持交互式聊天模式，可保存和恢复会话历史；支持管道输入，能直接处理文件或命令输出；提供多种输出格式（如纯文本、JSON、Markdown）；可自定义角色和系统提示词，适应不同场景；支持使用本地模型或远程 API，灵活配置。项目设计简洁，依赖少，注重实用性和可扩展性，是开发者日常使用 AI 助手的便捷工具。

Star 增长趋势

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

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

技术标签

chatgpt cli

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

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

环境要求

Python 环境与 pip（用于 pip 安装）
OpenAI API Key（必须，否则无法使用）
macOS 可选：Homebrew（用于 brew 安装）
终端可访问网络以调用 OpenAI 接口

安装与启动步骤

1准备 API 密钥

在 OpenAI 后台获取 API Key，README 要求必须配置密钥才能使用 chatblade。
2设置环境变量

推荐用环境变量方式传入密钥，避免写进命令历史；把示例值换成你自己的 Key。
```
export OPENAI_API_KEY=sk-xxxxxxxx
```
3从 PyPI 安装

安装最新发布版本，加 --upgrade 可覆盖升级旧版本。
```
pip install chatblade --upgrade
```
4或装主分支版本

README 提供直接从 GitHub 主分支安装的方式，可获取最新未发布改动。
```
pip install 'chatblade @ git+https://github.com/npiv/chatblade'
```
5Homebrew 安装

macOS 用户也可用 Brew 安装，按 README 给出的公式名执行即可。
```
brew install chatblade
```
6发起查询

直接把问题作为参数传入，即可开始一次新对话；换成你自己的问题即可。
```
chatblade "how can I center a div with CSS"
```

关键配置

配置项	必填	说明	示例
`OPENAI_API_KEY`	是	环境变量形式的 OpenAI 密钥，README 推荐这种配置方式	`sk-xxxxxxxx`
`--openai-api-key`	否	命令行参数形式传入密钥，替代设置环境变量	`--openai-api-key sk-xxxxxxxx`