Skip to content

Memre001/OpenHelio

Repository files navigation

OpenHelio

Version Language License


Reduce 3D print failures without touching geometry

OpenHelio post-processes G-code to make prints safer by adjusting feedrates only.

  • No geometry changes
  • No support modifications
  • Deterministic output

Why use it?

Most slicers optimize for speed, not stability.

OpenHelio sits after slicing and fixes risky motion patterns:

  • slows down unstable bridges
  • reduces overhang failure risk
  • smooths thermal spikes

All without changing your model or supports.


Example

Before:

G1 X120 Y120 F6000

After:

G1 X120 Y120 F4200

Same path. Safer motion.


Guarantees

  • Geometry is never modified (X/Y/Z/E stay identical)
  • Supports remain untouched
  • Only feedrate (F) is changed
  • Output is validated before overwrite
  • Deterministic output (hash verified)

Features

  • Zero-touch safety — supports and geometry are preserved
  • Deterministic AST processing — same input = same output
  • Confidence-based validation — PASS / WARN / FAIL
  • Risk detection — bridge, overhang, thermal buildup
  • Multi-slicer validation — Cura / OrcaSlicer / PrusaSlicer
  • Atomic safe-write — no corrupted G-code ever written
  • Printer-aware calibration — adapts using printer profile
  • Physical risk estimation — layer-based heatmap (heuristic)

OrcaSlicer Integration (1-minute setup)

  1. Open OrcaSlicer
  2. Go to Post-processing scripts
  3. Add:
C:\path\to\openhelio.exe

Done.

OpenHelio will automatically:

  • receive the generated G-code
  • optimize it
  • overwrite it safely

No extra config needed.


CLI Usage

openhelio [options] <input.gcode>

Common Flags

Flag Description
`--profile fast balanced quality` Optimization profile
--safe-mode Conservative mode
--confidence-report Show metric confidence
--physical-validate Run physical risk estimation
--multi-slicer-validate Compare slicer outputs
--explain Show risk breakdown
--dry-run No file output

Examples

openhelio --profile balanced input.gcode
openhelio --physical-validate --explain input.gcode
openhelio --multi-slicer-validate cura.gcode orca.gcode prusa.gcode

Build

Windows

cmake -S . -B build
cmake --build build --config Release

Linux / macOS

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

How it works

  1. Parses G-code into a deterministic AST
  2. Analyzes motion risk (thermal, bridge, overhang)
  3. Applies bounded feedrate adjustments
  4. Validates output (geometry + supports unchanged)
  5. Writes file safely using atomic overwrite

Important Note

OpenHelio uses a deterministic heuristic model to estimate print risks.

It is:

  • conservative
  • transparent
  • reproducible

It is not a full physics simulator.


When to use it

  • prints fail on bridges
  • overhangs look unstable
  • you want safer prints without re-slicing
  • you don’t trust slicer speed decisions

License

GPL v3


Status

Stable core ready. Actively evolving toward full digital twin optimization.


If this helps you

Give it a star ⭐ And test it on your next print.

About

Deterministic C++17 G-code post-processing optimizer focused on safer 3D print motion planning with OrcaSlicer, Cura, and PrusaSlicer integration.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages