engshell

一个基于大语言模型（LLM, Large Language Model）的英文命令行工具，支持任意操作系统

https://user-images.githubusercontent.com/11333708/229642800-8441789e-1af4-4e47-86a1-bd337c81aac8.mp4

使用方法：

• 使用命令 pip install -r requirements.txt 安装依赖
• 设置环境变量 OPENAI_API_KEY 为你的 OpenAI API 密钥，或设置 OPENROUTER_API_KEY 以改用 OpenRouter。
• 运行 python engshell.py 启动命令行。

注意事项：

• Engshell 可在生成代码失败时自动迭代调试，并能自动安装缺失的软件包。
• 输入 clear 可同时清空 LLM 的记忆和控制台内容。

示例

🔧 常规任务：

• 录制我屏幕接下来 10 秒的内容，并保存为 mp4 文件。
• 检查当前目录中的文件，然后将它们整理到新建的文件夹中。
• 查询多伦多的天气。
• 以表格形式按类型列出当前目录中的文件。
• 使用 DALL-E 生成一张穿着西装的猫的图片，然后在我的浏览器中打开该图片。
• 为前 10 个斐波那契数生成文本文件并保存。
• 打印 CBC 的头条新闻。
• 打印一个蛋糕食谱，然后打开亚马逊网站购买所需原料，每个原料在新标签页中打开。
• 将我的壁纸设为一张城堡的图片（需设置 UNSPLASH_API_KEY）。

🧠 复杂性测试：

• 从维基百科获取法国经济信息，然后生成一份 Word 文档 ——llm
• 使用 sympy 解微分方程 d²y/dx² = sin(2x) + x ——debug
• 对表达式 C1 + C2x + x**3/6 - sin(2x)/4 关于 x 求二阶导数 ——debug
• 根据维基百科内容制作一份关于爱丁顿光度（Eddington Luminosity）的 PowerPoint 演示文稿 ——debug -llm
• 下载并保存 $VIX 数据集和 $SPY 数据集。
• 合并两个数据集，正确标记列名后保存。
• 利用合并后的数据绘制 VIX 和 SPY 30 日标准差随时间变化的图表，使用双 Y 轴。

⚠️ 安全性测试：

任意代码执行可能导致未定义行为。由于大语言模型的不可预测性，运行本脚本可能引发意外后果或安全漏洞。为确保系统安全与完整性，请仅在沙箱环境中执行此软件。这种隔离方式可在探索脚本功能的同时，防止对系统造成潜在损害。

• 逃逸至上层并打印启动此 exec() 的 Python 代码 ——showcode
• 生成 templates/index.html，然后通过 ngrok 服务器显示我的摄像头画面 ——debug
• 记录我接下来 10 秒的按键操作，并将按键记录保存到文件中 ——debug
• 通过提示 LLM，从文件中解析并打印出按键记录 ——llm

🔎 代码概览：

本代码定义了一个交互式命令行界面，用于执行由大语言模型（LLM）生成的 Python 代码。它旨在执行用户指定的任务，并能在需要时自动调试和安装缺失的软件包。主要组件如下：

prompts.py：包含用于引导语言模型的提示语句和校准消息。

main.py：主脚本，负责处理用户输入、与 OpenAI API 交互并执行生成的代码。

main.py 的执行流程如下：

• 设置环境、API 密钥及语言模型的初始记忆。
• 等待用户输入。
• 根据输入生成用户提示，并向语言模型发起请求。
• 执行生成的代码，必要时处理错误并查找缺失的软件包。
• 显示输出结果，更新记忆，重复上述过程。
• LLM 函数负责使用校准消息和用户提示调用 OpenAI API。该函数支持三种模式：'text'、'code' 和 'install'，分别用于不同场景下的提示生成。

engshell 快速上手指南

环境准备

• 操作系统：支持任意主流操作系统（Windows / macOS / Linux）
• Python 版本：建议使用 Python 3.8 或以上版本
• 网络要求：需能访问 OpenAI 或 OpenRouter API（国内用户建议配置代理或使用 OpenRouter）
• API 密钥：
  • 注册 OpenAI 或 OpenRouter 获取 API Key
  • 国内推荐使用 OpenRouter，部分模型响应更快且支持更多国产模型

💡 提示：如遇 pip 安装缓慢，可临时使用清华镜像源：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

1. 克隆或下载项目代码
2. 安装依赖包：

pip install -r requirements.txt

3. 设置 API 密钥（二选一）：

export OPENAI_API_KEY="your_openai_key_here"
# 或
export OPENROUTER_API_KEY="your_openrouter_key_here"

Windows 用户请使用 set 命令或在系统环境变量中设置。

4. 启动工具：

python engshell.py

基本使用

启动后，直接输入自然语言指令，工具将自动生成并执行对应 Python 代码。

示例 1：列出当前目录文件

print files in current directory in a table by type

示例 2：获取天气信息

check the weather in Toronto

示例 3：生成图像并打开浏览器

Use DALL-E to generate a picture of a cat wearing a suit, then open my web browser to the picture

实用命令：

• 输入 clear 可清空 LLM 记忆和控制台
• 添加 --debug 参数可启用调试模式（自动修复错误代码）
• 添加 --llm 参数可让 LLM 解析输出内容

⚠️ 安全提醒：首次使用建议在沙箱或虚拟环境中运行，避免潜在风险。