Gorilla CLI

Gorilla CLI 以用户为中心的工具，为您的命令行交互提供强大支持。您只需简单描述目标，Gorilla CLI 就会生成可供执行的潜在命令。目前，Gorilla 支持约 1500 个 API，包括 Kubernetes、AWS、GCP、Azure、GitHub、Conda、Curl、Sed 等众多服务。再也不用费力回忆复杂的 CLI 参数了！🦍

Gorilla-CLI 由加州大学伯克利分校作为研究原型开发，始终将用户控制权和数据隐私放在首位：

• 命令仅在您明确批准后才会执行。
• 虽然我们会利用查询和错误日志（stderr）来优化模型，但我们绝不会收集输出数据（stdout）。

快速开始

您可以使用 pip 轻松安装 Gorilla CLI。

pip install gorilla-cli

使用方法

通过 gorilla 命令启动 Gorilla CLI，后面跟上用自然语言描述的任务即可。

例如，要生成一个包含 100 个随机字符的文件，可以输入：

$ gorilla generate 100 random characters into a file called test.txt

或者，如果您担心字符串解析问题，也可以用引号包裹整个指令：

$ gorilla "generate 100 random characters into a file called test.txt"

Gorilla CLI 会生成候选命令列表。使用方向键浏览选项，然后按 Enter 键执行选定的命令。

🦍  欢迎使用 Gorilla。请使用方向键选择
 » cat /dev/urandom | env LC_ALL=C tr -dc 'a-zA-Z0-9' | head -c 100 > test.txt 
   echo $(head /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | dd bs=100 count=1) > test.txt
   dd if=/dev/urandom bs=1 count=100 of=test.txt

更多示例：

$ gorilla list all my GCP instances
» gcloud compute instances list --format="table(name,zone,status)"
  gcloud compute instances list --format table
  gcloud compute instances list --format="table(name, zone, machineType, status)"

$ gorilla get the image ids of all pods running in all namespaces in kubernetes
» kubectl get pods --all-namespaces -o jsonpath="{..imageID}"
  kubectl get pods --all --namespaces
  kubectl get pod -A -o jsonpath='{range .items[*]}{"\n"}{.metadata.name}{"\t"}{.spec.containers[].image}{"\n"}{end}'

工作原理

Gorilla-CLI 融合了多种语言模型（LLM）的能力，如 Gorilla LLM、OpenAI 的 GPT-4、Claude v1 等，从而提供一个友好易用的命令行界面。对于每个用户查询，我们都会从所有参与的 LLM 中收集响应，经过筛选和排序后，为您呈现最相关的选项。

参数说明

usage: go_cli.py [-h] [-p] [command_args ...]

Gorilla CLI 帮助文档

位置参数:
  command_args   输入给 Gorilla 的提示语

可选参数:
  -h, --help     显示帮助信息并退出
  -p, --history  显示命令历史

历史功能允许用户返回之前执行过的命令，并以类似终端历史的方式重新执行。

贡献

我们欢迎您对 Gorilla CLI 的改进！如果您有改进建议，请随时在我们的 GitHub 页面提交 Pull Request。

许可证

Gorilla CLI 采用 Apache 2.0 许可证。更多详情请参阅 LICENSE 文件。同时，我们也衷心感谢 questionary 提供的优秀 UI！

Gorilla CLI 快速上手指南

Gorilla CLI 是一款由加州大学伯克利分校研发的智能命令行工具。它利用大语言模型（LLM）将您的自然语言描述转化为具体的命令行指令，支持 Kubernetes、AWS、GCP、Azure、GitHub 等约 1500 种 API 和工具，让您无需记忆复杂的参数即可高效操作。

环境准备

• 操作系统：支持 Linux、macOS 及 Windows (WSL)。
• 前置依赖：
  • Python 3.8 或更高版本。
  • pip 包管理工具。
• 网络要求：首次运行需联网以调用后端 LLM 服务。

安装步骤

通过 pip 即可快速安装 Gorilla CLI。

pip install gorilla-cli

提示：如果您在国内遇到下载速度慢的问题，推荐使用国内镜像源加速安装：

pip install gorilla-cli -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

安装完成后，只需在终端输入 gorilla followed by 您的任务描述（英文），即可生成候选命令。

1. 生成并执行命令

使用自然语言描述您的需求。例如，生成一个包含 100 个随机字符的文件：

$ gorilla generate 100 random characters into a file called test.txt

或者使用引号包裹整个句子以避免解析问题：

$ gorilla "generate 100 random characters into a file called test.txt"

交互流程：

1. Gorilla 会列出多个候选命令。
2. 使用 方向键 (↑/↓) 浏览选项。
3. 按 Enter 键执行选中的命令。

示例输出：

🦍  Welcome to Gorilla. Use arrows to select
 » cat /dev/urandom | env LC_ALL=C tr -dc 'a-zA-Z0-9' | head -c 100 > test.txt 
   echo $(head /dev/urandom | LC_CTYPE=C tr -dc 'a-zA-Z0-9' | dd bs=100 count=1) > test.txt
   dd if=/dev/urandom bs=1 count=100 of=test.txt

2. 更多实用示例

列出 GCP 上的所有实例：

$ gorilla list all my GCP instances
» gcloud compute instances list --format="table(name,zone,status)"

获取 Kubernetes 中所有命名空间下运行 Pod 的镜像 ID：

$ gorilla get the image ids of all pods running in all namespaces in kubernetes
» kubectl get pods --all-namespaces -o jsonpath="{..imageID}"

3. 查看历史命令

使用 -p 或 --history 参数可以查看并重新执行之前的命令记录：

$ gorilla -p