项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 16750
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Docker(本地执行必需,README 明确要求)
- Python 3.10+(示例和本地运行时必需)
- 已安装 uv/uvx 命令(README 用 uvx 调用 opensandbox-server)
安装与启动步骤
-
1确认环境依赖
先确认本机已安装 Docker 与 Python 3.10 及以上版本,这是本地运行沙箱的前置条件。
-
2初始化配置文件
用官方命令生成沙箱服务配置,--example docker 表示采用 docker 配置模板。
uvx opensandbox-server init-config ~/.sandbox.toml --example docker -
3启动沙箱服务
执行服务端命令启动 OpenSandbox,终端会持续占用,不要关闭该窗口。
uvx opensandbox-server
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
~/.sandbox.toml | 是 | 沙箱服务配置文件,由 init-config 命令生成 | ~/.sandbox.toml |
--example | 是 | init-config 的模板参数,README 使用 docker 模板 | docker |
如何确认成功
执行启动命令后终端无报错并持续运行,即表示服务已启动(README 未给出端口或健康检查地址)。
常见问题
Q:提示找不到 uvx 命令怎么办?
A:uvx 属于 uv 工具链,需先在本机自行安装 uv;README 只给出 uvx 调用方式,未提供 uv 的安装命令。
Q:没有 Docker 可以运行吗?
A:不可以。README 明确把 Docker 列为本地执行(local execution)的必需依赖,缺少 Docker 将无法正常启动沙箱。
Q:配置文件一定要放在 ~/.sandbox.toml 吗?
A:README 示例使用该路径,init-config 的第一个参数就是配置文件输出路径,可自行替换为其他可写路径。
Q:Python 版本低于 3.10 会怎样?
A:README 要求 Python 3.10+,低版本可能无法运行示例和本地运行时,建议升级后再执行后续步骤。
注意事项
- README 节选未提供端口号、API 调用示例和 Docker 镜像名,相关参数请以官方文档 open-sandbox.ai 为准。
- 启动命令依赖 uvx,若国内网络拉取缓慢可先配置好 Python 包源后再执行。
- 配置文件生成后建议先检查一遍再启动服务,避免模板与实际环境不匹配。
核心亮点
- 基于Kubernetes,沙箱可弹性伸缩,支持大规模并发执行
- 细粒度权限控制,可限制系统调用和网络访问,安全性高
- 冷启动延迟低,执行效率高,适合高频调用场景
不足之处
- 部署依赖Kubernetes,对轻量级用户来说运维成本偏高
- 文档/社区待观察
适用场景
- AI编程助手执行用户代码并隔离风险
- 自动化测试中运行不可信代码
- 多租户SaaS平台为每个租户提供隔离执行环境
替代项目
E2B、Firecracker、gVisor
同类项目推荐
mere-run
开源
在 Mac 上一条命令跑通图像、语音、视频等本地 AI 工作流
Run local image, text, speech, vision, music, and video workflows, plus model manage···
metal-flash-attention
开源
在 Apple 芯片上让注意力计算飞起来,加速 Stable Diffusion 推理。
FlashAttention (Metal Port)
GPT_API_free
开源
免费拿GPT/DeepSeek等大模型API,每日刷新额度,开发测试不花钱
免费大模型API,支持免费调用GPT、DeepSeek等主流模型,免费额度10000点,每日刷新!另付费···
seait
开源
一键安装主流 AI 绘画工具,告别命令行折腾
SEAIT is a user-friendly application that simplifies the installation process of AI-···
openai-compatible-api-migration-···
开源
换 AI 网关不翻车,示例+回滚+清单一次给齐
OpenAI-compatible API migration kit: drop-in /v1/images/generations and chat example···
MNNServer
开源
在手机上跑本地AI服务,离线也能语音对话和识别
A third-party MNN server supporting external calls, embedding model, TTS model and A···
mlops-v2
开源
用模板在 Azure 上快速搭建企业级机器学习自动化流水线
Azure MLOps (v2) solution accelerators. Enterprise ready templates to deploy your ma···
context-lens
开源
一眼看清 AI 到底收到了什么上下文
See what your AI sees. Framework-agnostic LLM context window visualizer.
sample-genai-on-eks-starter-kit
开源
在 EKS 上快速搭建生产级 GenAI 基础设施,省心省力
A comprehensive toolkit for deploying production-ready Generative AI infrastructure ···
