3D sandbox
Blender, FreeCAD, CadQuery and OpenSCAD for creating 3D assets with scripts. Run Blender Python with briq_exec for meshes, materials, GLB and CPU renders; cad-python for dimensioned CAD and STEP/STL; freecad-python for FreeCAD documents; openscad for .scad models. Files stay in /work. CPU only; AutoCAD and native DWG tools are not included.
- sandbox
- 3d
- cad
Guide: Create 3D assets
Run it
briq run 3d-sandboxbriq_run({ recipe: "3d-sandbox", wait: true })curl -X POST https://api.briq.cloud/v1/briqs \
-H "Authorization: Bearer $BRIQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"recipe": "3d-sandbox",
"wait": true
}'
# → { "briqs": [{ "id": "bq_…", … }], "outputs": { "SANDBOX_HOST": "…" }, … }
# ... when done, for each briq id
curl -X DELETE https://api.briq.cloud/v1/briqs/<id> \
-H "Authorization: Bearer $BRIQ_API_KEY"stack: app
services:
sandbox:
recipe: 3d-sandbox
# its defaults, each a field you can set:
# image: ghcr.io/briq-cloud/sandbox:3d
# size: small
# volume: { gb: 10 }Fields
| Name | Type | Options | Default |
|---|---|---|---|
| image | string | — | "ghcr.io/briq-cloud/sandbox:3d" |
| env | record | { key: string | { secret, value?, literal?, scope?, hosts?, locations? } } | {} |
| steps | object[] | — | — |
| cmd | string | string[] | — | — |
| size | enum | pico, micro, nano, small, medium, large, xlarge | "small" |
| volume | object | { gb? } | {"gb":10} |
| files | record | { key: string | { base64 } } | — |
Outputs
Returned by briq_run once the stack is healthy. Hosts resolve inside your team network; secrets are generated per run.
- SANDBOX_HOST
- sandbox.<stack>.internal
- WORKDIR
- /work
- PORT
- 8080
What it runs
| Briq | Image | Ports | Size | Volume |
|---|---|---|---|---|
| sandbox | ghcr.io/briq-cloud/sandbox:3d | 8080 | small | 10 GB at /work |
When to use it
- Meshes, materials, scenes and CPU renders with Blender Python.
- Dimensioned parts with CadQuery, FreeCAD or OpenSCAD.
- Asset inspection with trimesh, or DXF drawings with ezdxf.
Step by step: Create 3D assets.
Tips
- Choose the tool: Blender for visual assets; CadQuery for precise parts; FreeCAD for
.FCStd; OpenSCAD for.scad. - Use the right Python: Blender runs
bpy;cad-pythonruns CadQuery, trimesh and ezdxf;freecad-pythonruns FreeCAD. - Keep source and exports: save scripts,
.blendand.FCStdalongside GLB, STEP or STL in/work. - Render on CPU: use Cycles with
scene.cycles.device = 'CPU'. GPU acceleration and a desktop are not included. - Check the result: inspect a PNG, dimensions and mesh topology before delivering the asset.
- Long jobs: use
briq_execwithasync: true, then read the same exec withbriq_exec_result. - Large exports: use
briq files-get; MCP file transfers accept 1 MB per file. See CLI. - AutoCAD: native AutoCAD and DWG conversion are not included. Use DXF for drawing interchange.
Sandbox
An isolated Linux workspace for scripts, builds and tests.
Android emulator
An Android emulator (Pixel 6, Android 14, x86_64) running in a sandbox: it is ready once Android has booted. Use `adb` through briq_exec: `adb install app.apk`, `adb shell input tap 100 200`, `adb exec-out screencap -p > /work/s.png`, then briq_files_get. The first start downloads the Android SDK and system image (5 GB) into /work/sdk, about 2 minutes; later starts take about 30 to 40 seconds. Default size large (4 CPUs, 8 GB); medium works. Pro and Team plans. The first start accepts the Android SDK License Agreement (https://developer.android.com/studio/terms).