Bellerophon: The Parametric DSL for Additive Manufacturing

Bellerophon is a compiled domain-specific language (DSL) and IDE designed to replace rigid G-code scripts with structured, parametric macros. By acting as a universal abstraction layer, it allows you to write complex procedural geometry and machine control logic once, and compile it directly into target-specific formats like Klipper, Marlin, or other types of firmware.

---

---

What This Means for You

• Write Once, Deploy Anywhere - One script, all firmware.
• Safety-First - Simulate before you print. Prevent bed crashes.
• Parametric Capabilities - Variables, math, loops.
• 100% Local - All local network features are and will remain free.

---

Key Components

Bellerophon IDE: A real-time syntax-validating editor for authoring multi-firmware macros.

CFG Generator & Boundary Checker: A visual configuration app that validates hardware pins and simulates G-code paths to prevent physical bed crashes.

Gravity Hub (Beta): A dynamic fleet deployment layer for managing and syncing compiled scripts across local network printers.

---

Compilation Architecture

Bellerophon uses a decoupled Firmware Adapter Architecture. Your .bph source code remains universal, while the compiler handles the conversion to firmware-specific instructions via targeted adapters.

• Universal Source: Write once, deploy anywhere.
• Modular Adapters: Choose firmware target in IDE before compiling.
• Firmware Independence: New adapters can be added without changing scripts.

---

First Steps: Your First Macro

M.title "first_line"
Absolute
SetSpeed = 2000
Home
MoveTo x=100 y=100 z=0.2
MoveTo x=150 y=100
MoveTo x=150 y=150
MoveTo x=100 y=150
MoveTo x=100 y=100
Home
M.end

What this does

1. Home - Moves the printer to its origin.
2. Absolute - Uses absolute positioning so all coordinates are based on the printer’s origin.
3. SetSpeed = 2000 - Sets a moderate movement speed for the macro (mm/min).
4. MoveTo x=100 y=100 z=0.2 - Moves to the starting point slightly above the bed.
5. MoveTo x=150 y=100 - Moves along the X axis.
6. MoveTo x=150 y=150 - Moves along the Y axis.
7. MoveTo x=100 y=150 - Moves along the X axis.
8. MoveTo x=100 y=100 - Returns to the starting point, completing a square path.
9. Home - Returns the printer to its origin.

Quick Start

1. Download: Grab the latest release from the Releases page.
2. Run: Unzip the folder and launch the application:
   • Windows: Double-click run.bat
   • Mac/Linux: Run ./run.sh
3. Compile:
   • Paste your code into the editor.
   • Select your firmware dialect.
   • Click Compile to generate your G-code.
4. Visualize (Optional): Use the CFG Generator tab to preview your path on the printer bed.

[!TIP] Check out the References in the IDE or Documentation in the application for more information on Bellerophon.

Windows Security Prompts (What to Expect)

Example of the Windows security warning you may see when running for the first time.

• First-run firewall popup: Because the app opens a local web server, Windows may display a "Windows Defender Firewall" dialog asking whether to allow the app to communicate on networks. This is normal! For the official release it is safe to click "Allow access".
• SmartScreen / Defender warning: For unsigned downloads you may see a "Windows protected your PC" SmartScreen message. If you see it, click "More info" then "Run anyway".

Developers

For local development instructions, see CONTRIBUTING.md.

Full documentation

See Official_Bellerophon Language _ Documentation.pdf for the complete command reference, examples, and limitations.