用途
python-executor 用于在安全的、隔离的沙箱环境中执行 Python 代码。它通过 inference.sh 提供,适合需要运行 Python 脚本但不愿在本地配置环境的场景,例如网页抓取、数据分析、图像处理、视频生成、3D 模型处理、API 调用和 PDF 生成等。
主要能力
该工具预装了 100 多个 Python 库,按类别包括:
- 网络抓取与 HTTP:requests、httpx、aiohttp、beautifulsoup4、lxml、selenium、playwright、scrapy
- 数据处理:numpy、pandas、scipy、matplotlib、seaborn、plotly
- 图像处理:pillow、opencv-python-headless、scikit-image、imageio
- 视频与音频:moviepy、av(PyAV)、ffmpeg-python、pydub
- 3D 处理:trimesh、open3d、numpy-stl、meshio、pyvista
- 文档与图形:svgwrite、cairosvg、reportlab、pypdf2
运行环境为 Python 3.10,仅使用 CPU,不提供 GPU/机器学习库。内存默认 8GB,也可选用 16GB 的 high_memory 变体。超时时间可设置为 1 至 300 秒,默认 30 秒。
输入通过 JSON 提供,字段包括 code、timeout、capture_output、working_dir。保存到 outputs/ 目录的文件会被自动检测并随响应返回,例如图片、CSV、视频和 3D 模型。
使用方式
首先需要安装 belt CLI 并登录:
npx skills add belt-sh/cli
belt login
然后按以下方式运行 Python 代码:
belt app run infsh/python-executor --input '{
"code": "import pandas as pd\nprint(pd.__version__)"
}'
输入 JSON 示例:
{
"code": "print('Hello World!')",
"timeout": 30,
"capture_output": true,
"working_dir": null
}
使用高内存变体(16GB RAM):
belt app run infsh/python-executor@high_memory --input input.json
适用场景
- 网页抓取:从网站提取数据
- 数据分析:处理并可视化数据集
- 图像处理:调整尺寸、裁剪、合成图像
- 视频创建:生成带文字叠加的视频
- 3D 处理:加载、变换、导出 3D 模型
- API 集成:调用外部 API
- PDF 生成:创建报告和文档
- 自动化:运行任意 Python 脚本
限制与注意事项
- 仅支持 CPU,不包含 GPU/ML 库;如需机器学习相关功能,资料建议使用专门的 AI 应用。
- 代码在隔离的子进程中执行,为非交互式环境,应使用 plt.savefig() 而非 plt.show()。
- 输出文件通过 outputs/ 目录自动返回。
- 环境为 Python 3.10,内存默认 8GB,超时可设 1-300 秒。
相关技能
资料中提及的相关技能包括:
- AI 图像生成:npx skills add inference-sh/skills@ai-image-generation
- AI 视频生成:npx skills add inference-sh/skills@ai-video-generation
- LLM 模型:npx skills add inference-sh/skills@llm-models