Skip to content

Konjugate v0.6.0: Command-line mode and a few old examples back

Choose a tag to compare

View all tags
@github-actions github-actions released this 20 Aug 12:23
· 53 commits to master since this release
v0.6.0
66ed1c3

Command-line mode

Konjugate can now run a project headlessly from a terminal; no window opens, and it exits when the run finishes. This makes it possible to script simulation runs, batch multiple models, or automate result generation without touching the GUI at all.

# macOS
/Applications/Konjugate.app/Contents/MacOS/Konjugate --cli run model.kjt --target-time 30 --output-kjt result.kjt --output-csv result.csv

# Windows
Konjugate.exe --cli run model.kjt --target-time 30 --output-kjt result.kjt --output-csv result.csv

# Linux (AppImage)
./Konjugate-*-linux-x64.AppImage --cli run model.kjt --target-time 30 --output-kjt result.kjt --output-csv result.csv
  • --cli run <project.kjt> --target-time <seconds> runs the project's active run configuration (or --configuration <name-or-id> to pick another).
  • --output-kjt <path> writes a new .kjt with the result embedded, exactly like saving after a run in the GUI.
  • --output-csv <path> exports the same signal columns the GUI's CSV export produces — opens directly in Excel or any spreadsheet app.
  • --cli validate <project.kjt> prints a validation report as JSON and exits 0 if valid, 2 if not.
  • An encrypted .kjt reads its password from a KONJUGATE_PASSWORD environment variable, never a command-line flag, so it never lands in shell history.

A CLI invocation always runs as its own independent process, even while a GUI instance is already open elsewhere. Under the hood, a headless run also skips the live-progress streaming the GUI needs, so long unattended runs spend their time on the simulation itself rather than on progress bookkeeping nobody's watching.

A few examples are back

Heated Water Tank, Spring–Mass–Damper, Two-Room Building and Thermal Equilibrium have rejoined the bundled example set, each with a guide rewritten to match the rest of the library — governing equations, how they map onto the model's actual edges and source terms, and what to expect when you run them. They round out the set with simple, single-concept models (a bare thermal tank, a classic mechanical oscillator, a multi-zone building and the bidirectional-edge feature in isolation) alongside the more elaborate robotics examples already there.

Fixes

  • Corrected a packaging test that had drifted out of sync with how the app is actually packaged, so it once again verifies that third-party notices and licenses ship correctly.

Installation notes: Konjugate isn't code-signed yet (an active choice while the project is in alpha), so your OS may show a security warning on first launch. This doesn't mean the download is corrupted.

  • macOS — if you see "is damaged and can't be opened": move Konjugate.app to Applications, then in Terminal run xattr -cr /Applications/Konjugate.app. Or: System Settings → Privacy & Security → Open Anyway.
  • Windows — if you see a blue "Windows protected your PC" warning from SmartScreen, click More info, then click the Run anyway button that appears.

Full Changelog: v0.5.13...v0.6.0

Assets 6
Loading