https://github.com/danburonline/headless-blender

Proof of concept to run Blender in headless mode behind an HTTP API to run physics simulations (destruction of geometries), bake the simulations as keyframe animations, and return optimised 3D meshes.
https://github.com/danburonline/headless-blender

blender physics simulation

Last synced: 14 days ago
JSON representation

Proof of concept to run Blender in headless mode behind an HTTP API to run physics simulations (destruction of geometries), bake the simulations as keyframe animations, and return optimised 3D meshes.

• Host: GitHub
• URL: https://github.com/danburonline/headless-blender
• Owner: danburonline
• Created: 2023-12-01T16:18:11.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-03-07T08:55:06.000Z (11 months ago)
• Last Synced: 2025-01-19T22:12:44.842Z (14 days ago)
• Topics: blender, physics, simulation
• Language: Python
• Homepage:
• Size: 7.18 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Headless Blender

This repository is an experimental side project to determine the feasibility of running Blender in headless mode, without a graphical user interface (GUI), while still being able to render images and run simulations.

## Quick Start

1. Open the project via the Poetry shell: `poetry shell`

2. Install the project dependencies: `poetry install`

3. Run the example server: `uvicorn headless_blender.server:app --reload`

4. Test the health check: `curl http://localhost:8000/health`

5. Import the [API specs](./docs/api/specs.json) into Hoppscotch and use the API accordingly

## Docker

1. Build the Docker image: `docker build -t headless-blender .`

2. Run the Docker container: `docker run -p 8000:8000 headless-blender`

3. Test the health check: `curl http://localhost:8000/health`

4. Import the [API specs](./docs/api/specs.json) into Hoppscotch and use the API accordingly