ai-cli

ai-cli 项目简介

ai-cli 是一个命令行界面工具，专为方便地使用 chatGPT 和新 Bing 而设计。通过这个工具，用户可以在命令行中与聊天机器人对话、提问、翻译文本等，还支持在终端中渲染 Markdown 格式的内容。

项目依赖

为了顺利使用 ai-cli，需要配置一些 API 和环境变量：

• OPENAI_API_BASE（可选）：如果因网络限制无法访问 https://api.openai.com，可以通过设置 OPENAI_API_BASE 环境变量指向另一个 API 地址。这种方法比代理更稳定。

• OPENAI_API_KEY：使用 OpenAI 时，需要设置 OPENAI_API_KEY 环境变量，或通过 --api-key 参数指定该密钥。同样地，使用 Azure OpenAI 的用户需要设定相关的 Azure API 密钥和端点信息。

• Gemini Pro：需要设置 GOOGLE_API_KEY 或使用 --google-api-key 参数，并通过 ai setting 命令配置为 GeminiBot。

• Bard 支持（已弃用）：使用 Bard 机器人时，需登录 Google Bard。

• Bing Cookie：使用 Bing 机器人时，需要配置 Bing Cookie。可以通过 ai setting 命令设置。

安装

可以通过以下命令安装 ai-cli：

pip install py-ai-cli

或者安装最新版本：

pip install git+https://github.com/yufeikang/ai-cli.git

配置

使用 ai setting 命令可以设置 API 密钥和 API 基址。环境变量和命令行参数依然有效。

# 查看当前设置
ai setting
# 编辑设置
ai setting -e

功能使用

使用 ai -h 可查看所有支持的命令。以下是核心功能示例：

• 自动提交信息：

  ai commit
  

• 提问：

  ai ask "Hello"
  # 无流模式
  ai --no-stream ask "Hello"
  # 帮助
  ai ask --help
  # 使用预设问题
  curl -s URL | ai ask --prompt "summary this, how to install"
  

• 翻译：

  ai translate "Hello"
  ai translate "Hello" -t japanese
  ai translate -t english -f "file.txt"
  echo "Hello" | ai translate -t english
  cat "file.txt" | ai translate -t english
  

• 聊天：

  ai chat
  

• 代码审核：

  ai review
  ai review -t develop
  ai review -t HEAD~1
  

代理支持

推荐使用 OPENAI_API_BASE 配合正向代理。支持环境变量 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY，还可以通过 --proxy 参数指定代理。

示例：

export HTTP_PROXY=http://x.x.x.x:xxxx
# 或者
export HTTPS_PROXY=https://x.x.x.x:xxxx

支持 SOCKS5 代理，例如：

export ALL_PROXY=socks5://x.x.x.x:xxxx

使用 SOCKS5 代理需要安装 pysocks：

pip install pysocks

额外信息

使用 ai --help 可以查看更多命令。

特别感谢

该项目使用 JetBrains 产品开发。