Desktop Installation

Tribunus Desktop is packaged as a native Electron application. It is available for macOS (Apple Silicon and Intel) and Linux (x86_64). Windows is not currently supported in the developer preview.

macOS

1. Download the .dmg file for your architecture from the releases page.
2. Open the disk image and drag Tribunus Desktop into your Applications folder.
3. Launch the application from your Applications folder or Spotlight.

macOS may prompt you to allow the app to control other applications via accessibility permissions — this is required for Desktop’s automatic code-editing features. Grant this permission in System Settings > Privacy & Security > Accessibility.

Linux

1. Download the .tar.gz archive for Linux x86_64 from the releases page.
2. Extract the archive: tar -xzf tribunus-desktop-*.tar.gz
3. Run the executable from the extracted directory: ./tribunus-desktop

For desktop integration, you can move the extracted directory to /opt/tribunus-desktop and create a .desktop entry. An AppImage variant is also available for distribution-agnostic use.

Verify the installation

Run Tribunus Desktop and confirm that the welcome screen appears. From the Settings panel, verify that a supported inference backend is configured. If you are using Tribunus Compute, ensure the compute engine daemon is running on the default port.

Troubleshooting

• App does not launch on macOS: Check that you have granted the required permissions under Privacy & Security.
• Segfault on Linux: Ensure your system has a recent glibc (2.28 or later). Run ldd ./tribunus-desktop to verify library linkage.
• Backend not reachable: Confirm that Tribunus Compute (or your chosen backend) is running and that the port in Desktop’s settings matches the compute engine’s port.