Cute Chibi Dragon
Left Drag: Rotate
Right Drag / Shift: Pan
Scroll: Zoom
Environment:
3D Model Catalog
All 3D assets generated in this DevGrail workspace
Agent Quickstart Guide: 3D Modeling with Headless Blender
Instructions for autonomous agents and developers to build, export, and showcase 3D assets.
1
Write Blender Script
Create a python script in /workspace/generators/ using bpy and bmesh.
2
Execute Headless
Run blender -b -P <script.py>. Blender generates meshes, sets materials, and exports to .glb.
3
Instant Gallery Display
Save outputs to /workspace/gallery/public/models/. The web gallery discovers and displays them in 3D automatically.
Core Commands
Action
Command
Run generator script headlessly:
blender -b -P /workspace/generators/generate_model.py
Execute inline Python one-liner:
blender -b --python-expr "import bpy; print(bpy.app.version)"
Check Blender version:
blender --version
Restart Gallery service:
/workspace/.devgrail/startup.sh
Minimal Python Starter Template
/workspace/templates/template_generator.py
import bpy, bmesh, os, json
# 1. Clean default scene
bpy.ops.wm.read_factory_settings(use_empty=True)
# 2. Create Principled BSDF Material
mat = bpy.data.materials.new("Mat_Main")
mat.use_nodes = True
mat.node_tree.nodes["Principled BSDF"].inputs["Base Color"].default_value = (0.2, 0.8, 0.6, 1.0)
# 3. Create procedural geometry (e.g. UV sphere)
mesh = bpy.data.meshes.new("mesh_obj")
obj = bpy.data.objects.new("Model_Obj", mesh)
bpy.context.collection.objects.link(obj)
bm = bmesh.new()
bmesh.ops.create_uvsphere(bm, u_segments=32, v_segments=16, radius=1.0)
bm.to_mesh(mesh)
bm.free()
obj.data.materials.append(mat)
for poly in mesh.polygons:
poly.use_smooth = True
# 4. Export GLB
glb_path = "/workspace/gallery/public/models/my_model.glb"
bpy.ops.export_scene.gltf(filepath=glb_path, export_format='GLB')
print("Model saved to:", glb_path)
System Status & Environment
Runtime details for this DevGrail workspace
Workspace Configuration
- DevGrail Workspace ID: 883a7601-5bcc-4b79-9956-477bc729efd3
- Public Gallery URL: https://blender-gallery.devgrail.com/
- Blender Binary: /workspace/tools/blender/blender
- Gallery Port: 3000 (0.0.0.0:3000)
- Persistent Storage: /workspace