humanscript

项目介绍：humanscript

humanscript 是一种全新的脚本语言解释器，它通过大规模语言模型，理解用自然语言编写的命令背后的含义。用户可以以接近自然语言的方式编写命令，这些命令会即时被自动翻译成代码并执行。humanscript 没有固定的语法，使用者只需表达所希望的操作即可，该语言将自动为你实现。

特点

humanscript 支持多种大型语言模型（LLM）作为后端，包括云端的 OpenAI GPT-3.5 和 GPT-4，以及本地运行的开源 LLM，如 Llama 2。

示例

一个名为 tidy-screenshots 的 humanscript 可以将一个乱序的截图文件夹整理至按月份分类的子目录中。脚本大致如下：

#!/usr/bin/env humanscript

loop over all files (ignoring directories) in $HOME/Screenshots

move each file into a subdirectory in the format year-month

while the task is running show an ascii loading spinner

show how many files where moved

show the size of each subdirectory

执行方式与其他脚本相似：

$ ./tidy-screenshots
Moved 593 files.
364K    2023-08
2.3M    2023-02
...
23M    2022-05
30M    2023-05
...
66M    2022-08

上述脚本在运行时会被解释为 bash 脚本并逐行执行。首次执行时生成的代码会被缓存，后续调用时将直接执行缓存的代码，大大提升效率。

你可以查看演示效果：

使用方法

安装 humanscript

可以通过 Docker 运行：

docker run -it lukechilds/humanscript

或通过 Homebrew 在本地系统安装：

brew install lukechilds/tap/humanscript

也可以手动下载并将 humanscript 添加到你的 PATH 中。

注意：如果不使用沙箱环境运行 humanscript，解释器可能会执行一些不可预测和潜在危险的操作。为了避免不必要的麻烦，建议首次运行时使用 HUMANSCRIPT_EXECUTE="false" 进行代码检查。

编写与执行 humanscript

首先配置 OpenAI 的 GPT-4 API 密钥：

mkdir -p ~/.humanscript/
echo 'HUMANSCRIPT_API_KEY="<your-openai-api-key>"' >> ~/.humanscript/config

然后创建一个新的 humanscript：

echo '#!/usr/bin/env humanscript
print an ascii art human' > asciiman
chmod +x asciiman

执行它：

./asciiman
  O
 /|\
 / \

配置

可以在 ~/.humanscript/config 文件中配置环境变量，以应用于所有 humanscript：

$ cat ~/.humanscript/config
HUMANSCRIPT_API_KEY="sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
HUMANSCRIPT_MODEL="gpt-4"

也可以为单个脚本配置：

$ HUMANSCRIPT_REGENERATE="true" ./asciiman

重要配置项

• HUMANSCRIPT_API：默认为 https://api.openai.com/v1，指定使用的 API 接口。
• HUMANSCRIPT_API_KEY：API 密钥，主要用于 OpenAI。
• HUMANSCRIPT_MODEL：指定使用的语言模型，默认为 gpt-4。
• HUMANSCRIPT_EXECUTE：是否自动执行生成的代码，默认为 true。
• HUMANSCRIPT_REGENERATE：是否重新生成缓存的 humanscript，默认为 false。

humanscript 是一个通过自然语言进行编程的强大工具，帮助用户以更直观和简化的方式实现繁杂的脚本任务。欢迎你来体验这款自然语言编程的新工具！