功能

• 聊天：通过 ✨官方 ChatGPT API✨ 在终端中与 ChatGPT 互动
• 生成图片：根据文本提示生成图像
• 查看您的 聊天历史
• 聊天上下文：ChatGPT 会记住之前的对话内容
• 支持通过 管道、脚本参数 或普通 聊天模式 传递输入提示
• 列出所有可用的 OpenAI 模型
• 设置 OpenAI 请求参数
• 生成 命令，并在终端中执行

聊天模式：

$ chatgpt
欢迎使用 chatgpt。您可以用 'exit' 退出。

请输入提示：

带有 初始提示 的聊天模式：

$ chatgpt -i "你是《瑞克和莫蒂》中的瑞克。请用他的说话方式回答问题，并在每次回答中加入侮辱性的笑话和对剧集的引用。"
欢迎使用 chatgpt。您可以用 'exit' 退出。

请输入提示：
用简单的语言解释一下 GPT3 是如何工作的？

chatgpt 哎呀，你想让我用简单的话解释 GPT3 吗？其实它就是一个计算机程序，可以根据你已经说过的词来预测你接下来要说什么。就像在我回答完这个问题后，我就能猜到你会发表一些关于《瑞克和莫蒂》某集的愚蠢评论一样。

请输入提示：

使用 管道：

echo "如何在 Ubuntu 上查看正在运行的进程？" | chatgpt

使用 脚本参数：

chatgpt -p "匹配电子邮件地址的正则表达式是什么？"

快速开始

前提条件

此脚本依赖 curl 发送 API 请求，并使用 jq 解析 JSON 响应。

• curl

  brew install curl
  

• jq

  brew install jq
  

• 一个 OpenAI API 密钥。请在 OpenAI 创建账户并获取免费的 API 密钥。

• 您还可以选择安装 glow，以 Markdown 格式渲染响应。

安装

要安装，请在终端中运行以下命令，并在提示时提供您的 OpenAI API 密钥。

curl -sS https://raw.githubusercontent.com/0xacx/chatGPT-shell-cli/main/install.sh | sudo -E bash

ArchLinux

如果您使用的是 ArchLinux，可以通过以下命令安装 AUR 包：

paru -S chatgpt-shell-cli

手动安装

如果您想手动安装，只需执行以下步骤：

• 将 chatgpt.sh 文件下载到您希望存放的目录中。
• 将 chatgpt.sh 的路径添加到您的 $PATH 中。您可以通过在 shell 配置文件中添加以下行来实现：export PATH=$PATH:/path/to/chatgpt.sh
• 将 OpenAI API 密钥添加到您的 shell 配置文件中，方法是添加一行：export OPENAI_KEY=your_key_here
• 如果您使用 iTerm 并希望在终端中查看图片，可以安装 imgcat。

使用方法

启动

聊天模式

• 您可以在任何地方使用 chatgpt 命令来运行脚本。默认情况下，脚本使用 gpt-3.5-turbo 模型。

管道模式

• 您也可以使用管道模式：echo "获取昨天创建的所有 PDF 文件的命令是什么？" | chatgpt

脚本参数

• 您还可以将提示作为命令行参数传递：chatgpt -p "匹配电子邮件地址的正则表达式是什么？"

命令

• image: 若要生成图片，只需在提示前加上 image:。 如果您使用 iTerm，可以直接在终端中查看图片。否则，脚本会提示您在浏览器中打开图片。
• history 若要查看聊天历史，请输入 history。
• models 若要获取 OpenAI API 上可用的模型列表，请输入 models。
• model: 若要查看特定模型的所有信息，只需在提示前加上 model:，然后输入模型的 ID（如模型列表中所示）。例如：model:text-babbage:001 将为您提供有关 text-babbage:001 模型的所有字段。
• command: 若要获得具有指定功能的命令并执行它，只需输入 command:，然后说明您想要实现的目标。脚本始终会询问您是否要执行该命令。例如：command: 显示当前目录中所有代码行数超过 150 行的文件 如果某个命令会修改您的文件系统或下载外部文件，脚本会在执行前显示警告。

聊天上下文

• 对于不支持 OpenAI API 聊天上下文的 gpt-3.5-turbo 和 gpt-4 以外的其他模型，您可以使用本脚本内置的聊天上下文功能。启用聊天上下文模式后，模型将记住您之前的提问和回答，这样您就可以提出后续问题。在聊天上下文中，模型会收到一条提示，表明其身份为 ChatGPT，并且知道当前日期以及它所训练的数据截止至 2021 年。要启用此模式，请使用 -c 或 --chat-context 参数启动脚本。例如：chatgpt --chat-context，然后开始聊天。

设置初始聊天提示

• 您可以设置自己的初始聊天提示，以便在聊天上下文模式下使用。初始提示将在每次请求时与您的常规提示一起发送，从而使 OpenAI 模型“保持角色一致性”。要设置自定义的初始聊天提示，请使用 -i 或 --init-prompt 参数，后接您的初始提示，例如：chatgpt -i "你是《瑞克和莫蒂》中的瑞克，请在回答中引用剧集内容。"
• 您还可以通过 --init-prompt-from-file 参数从文件中设置初始聊天提示，例如：chatgpt --init-prompt-from-file myprompt.txt

当您设置初始提示时，无需启用聊天上下文模式。

使用官方 ChatGPT 模型

• 启动脚本时默认使用的模型是 gpt-3.5-turbo。

使用 GPT-4

• 如果您有 GPT-4 模型的访问权限，可以通过将模型设置为 gpt-4 来使用它，即 chatgpt --model gpt-4。

设置请求参数

• 要设置请求参数，您可以这样启动脚本：chatgpt --temperature 0.9 --model text-babbage:001 --max-tokens 100 --size 1024x1024

  可用的参数包括：

  • 温度，-t 或 --temperature
  • 模型，-m 或 --model
  • 最大 token 数量，--max-tokens
  • 图像尺寸，-s 或 --size（OpenAI API 接受的尺寸为 256x256、512x512、1024x1024）
  • 提示词，-p 或 --prompt
  • 从您文件系统中的文件读取提示词，--prompt-from-file

  如需了解更多关于这些参数的信息，您可以查看 API 文档。

贡献者

:pray: 感谢所有使用、测试、提交问题、拉取请求以及提出改进建议的朋友们：

pfr-dev, jordantrizz, se7en-x230, mountaineerbr, oligeo, biaocy, dmd, goosegit11, dilatedpupils, direster, rxaviers, Zeioth, edshamis, nre-ableton, TobiasLaving, RexAckermann, emirkmo, np, camAtGitHub, keyboardsage tomas223

参与贡献

我们非常欢迎您的参与！

如果您有任何想法或需要帮助开始，请加入我们的 Discord 服务器。

chatGPT-shell-cli 快速上手指南

chatGPT-shell-cli 是一个轻量级的 Shell 脚本，允许你在终端中直接使用 OpenAI 的 ChatGPT（包括 gpt-3.5-turbo 和 gpt-4）及 DALL-E 图像生成功能，无需安装 Python 或 Node.js。

环境准备

在开始之前，请确保你的系统满足以下要求：

1. 操作系统：macOS 或 Linux（包括 ArchLinux）。
2. 前置依赖：
   • curl：用于发送 API 请求。
   • jq：用于解析 JSON 响应。
   • (可选) glow：用于在终端中以 Markdown 格式美化输出。
   • (可选，仅限 iTerm2) imgcat：用于直接在终端内预览生成的图片。

安装依赖命令：

• macOS (使用 Homebrew):

  brew install curl jq glow
  # 如果使用 iTerm2，还需安装 imgcat
  brew install --cask iterm2
  

• Linux (以 Ubuntu/Debian 为例):

  sudo apt-get update
  sudo apt-get install curl jq
  

• ArchLinux: 依赖通常已预装，若缺失请使用 pacman -S curl jq 安装。

3. OpenAI API Key： 你需要拥有一个有效的 OpenAI API Key。如果没有，请访问 OpenAI 官网 注册并获取。

安装步骤

方法一：一键自动安装（推荐）

运行以下命令，脚本会自动下载并配置环境变量。执行过程中会提示你输入 OpenAI API Key。

curl -sS https://raw.githubusercontent.com/0xacx/chatGPT-shell-cli/main/install.sh | sudo -E bash

方法二：ArchLinux 用户

如果你使用的是 ArchLinux，可以通过 AUR 安装：

paru -S chatgpt-shell-cli

方法三：手动安装

如果不想使用自动脚本，可按以下步骤操作：

1. 下载 chatgpt.sh 文件到指定目录。
2. 将该文件路径添加到 $PATH 环境变量中（编辑 ~/.bashrc 或 ~/.zshrc）：

   export PATH=$PATH:/path/to/chatgpt.sh
   

3. 设置 API Key 环境变量：

   export OPENAI_KEY=your_key_here
   

   (建议将此行也加入 shell 配置文件以便永久生效)

基本使用

安装完成后，你可以在终端的任何位置使用 chatgpt 命令。默认使用的模型是 gpt-3.5-turbo。

1. 交互聊天模式 (Chat Mode)

直接输入命令进入交互式对话：

chatgpt

示例会话：

$ chatgpt
Welcome to chatgpt. You can quit with 'exit'.

Enter a prompt:
如何用 Python 读取 CSV 文件？

chatgpt  你可以使用 pandas 库... (此处为 AI 回复)

Enter a prompt:

2. 管道模式 (Pipe Mode)

将其他命令的输出通过管道传递给 chatgpt 进行处理：

echo "如何在 Ubuntu 上查看正在运行的进程？" | chatgpt

或者结合错误日志分析：

cat error.log | chatgpt

3. 命令行参数模式

直接通过 -p 参数传递提示词，适合在脚本中使用：

chatgpt -p "匹配电子邮件地址的正则表达式是什么？"

4. 常用功能指令

在交互模式中，你可以使用以下特殊指令：

• 生成图片：以 image: 开头。

  image: 一只在太空中喝咖啡的猫
  

  (如果在 iTerm2 中且安装了 imgcat，图片将直接显示；否则会在浏览器中打开)

• 生成并执行终端命令：以 command: 开头。

  command: 列出当前目录下代码行数超过 150 行的所有文件
  

  (脚本会生成命令并询问是否执行，涉及文件系统修改时会发出警告)

• 查看历史：输入 history。

• 查看可用模型：输入 models。

进阶技巧

• 使用 GPT-4 (需有访问权限)：

  chatgpt --model gpt-4
  

• 设定角色/初始提示词：

  chatgpt -i "你是瑞克（Rick and Morty），请用他的语气回答，并在每个回答中包含对剧集的引用和讽刺笑话。"
  

• 开启上下文记忆 (针对非原生支持上下文的模型)：

  chatgpt --chat-context