Darkstar Robotics · Native macOS · Managed Linux Runtime

v0.3.0 — Released

Build.
Explore.
Deploy.

Darkstar Robotics is a robotics development workstation that lives on your MacBook while the Linux runtime runs managed underneath. No terminal. No apt locks. No version matrix. One calm place for ROS, Gazebo, PX4 — and the firmware inside the robot.

macOS 14+ host· Ubuntu 24.04 runtime in UTM· ROS 2 Jazzy + Gazebo Harmonic· Tailscale link
Features

Six modules. One workstation.

Everything a budding roboticist needs, arranged the way a flight line is: check the board, run the checks, pick the environment, load the mission.

Dashboard

Live state of the managed Linux runtime, the active Ubuntu / ROS / Gazebo pairing, PX4 SITL, and the Tailscale link — at a glance, without opening a terminal.

In v0.1

Preflight

A prerequisite checklist that probes this Mac and the runtime before anything flies — each failed item gets a one-click remedy where one exists.

In v0.1

Environments

Validated pairings, not version roulette. Pick what you want to build — Darkstar Robotics already knows which Ubuntu, ROS, and Gazebo versions go together.

In v0.1

Hardware

Photo and scan intake. Drop a picture of a board, flight controller, label, or QR code — your fleet starts from the hardware you actually own.

Intake in v0.1

Missions

The PX4 swarm-recovery golden demo, shipped with its verified evidence — separation, samples, and reassignments on the record, not in a slide deck.

Recorded

Viewer

Embedded replay and telemetry viewing, so a flight can be re-flown from the couch and every anomaly inspected frame by frame.

In v0.1
Demo

Watch it work.

A recorded walkthrough of the Darkstar Robotics app, driven page by page — Settings, Dashboard, Preflight, Environments, Hardware, Missions, Viewer — exactly as it runs on the Mac. Real frames of the installed v0.3.0 app, not a render. Press play.

Recorded RECORDED WALKTHROUGH · DARKSTAR ROBOTICS v0.3.0 · MAC APP · 12 S · PLAYS IN THIS PAGE
Architecture

Modular, not monolithic.

Darkstar Robotics is not an all-or-nothing installation. Nobody should have to install ROS 2, Gazebo, PX4, Docker, and dozens of other tools just to open the application. You start with the Core — everything else is opt-in.

“Darkstar Robotics Core must remain independently usable. Robotics applications, runtimes, SDKs, and hardware integrations are opt-in. Readiness is evaluated against the user's selected capabilities, not the entire software catalog.”

Product principle — Phase 1 spec

Layer 1

Core

The lightweight desktop application: system inspector, compatibility engine, application catalog, and diagnostics interface. No ROS, Gazebo, PX4, or simulator installation required to start.

Required — that's all
Layer 2

Optional Applications

Choose individual tools only when you need them — ROS 2, Gazebo, PlatformIO, OpenCV, QGroundControl, KiCad. Want only QGroundControl? Nothing forces ROS 2 or Gazebo along with it. Building for an ESP32? PX4 stays out of it.

Opt-in · per tool
Layer 3

Optional Stacks

Curated combinations for drone development, rovers, robot arms, embedded systems, and computer vision. Every component is individually selectable — a stack is a starting point, never an all-or-nothing bundle.

Proposed — not validated

Dependencies, in the open

A selected tool may need other software to work. Darkstar Robotics explains those dependencies and asks for approval — it never installs anything silently. Every dependency in the catalog is one of three types:

Required

Must be present for the selected capability to work at all. If it's missing, that capability — and only that capability — reports it.

Optional

Adds functionality, but the selected capability works without it. An absent optional dependency is never an error.

Alternative

A choice between supported implementations. Pick the one your workflow already uses; the catalog tracks either.

Two kinds of readiness

Workstation readiness

Is Darkstar Robotics itself functioning correctly — the Core application, its system inspector, and its diagnostics?

Measured against the Core only

Stack readiness

Does this machine meet the requirements of the specific tools and workflow you selected — and only the ones you selected?

Measured against your selection

Never selected PX4? Its absence is not an error and raises no dashboard warning. It simply reads Not Installed in the catalog — neutral, until the day you choose it.

One stack, your call

PX4 Drone DevelopmentProposed — not validated
ROS 2 JazzyRobot middleware
Optional
Gazebo Harmonic3D robot simulation
Optional
PX4Drone autopilot and SITL
Optional
QGroundControlGround control station
Optional
MAVSDKMAVLink programming SDK
Optional
DockerContainer runtime
Optional

CONCEPT LAYOUT — this page installs nothing and verifies nothing about your machine. Stack templates are proposed combinations; each needs a version matrix before Darkstar Robotics can claim it compatible. In the app, dependencies are explained and approved before anything installs.

Preflight

Nothing flies unchecked.

Before setup, before flight, Darkstar Robotics probes the host, the runtime, and the environment. Failures say why — and fix themselves where they can. Try the sequence:

·
Host memory & disk
MacBook RAM / free storage for the runtime image
Standby
·
Xcode & UTM
Toolchain present · VM hypervisor installed
Standby
·
VM state — Omega-Ubuntu
utmctl probe · guest reachable
Standby
·
Tailscale link
Tailnet up · SSH bridge to the guest
StandbyRemedy: reconnect →
·
ROS 2 · Gazebo · PX4
In-runtime stack · verified out-of-band in v0.1
Standby
DEMO SEQUENCE — the app runs these probes for real (utmctl, Tailscale CLI, FileManager).
Environments

Pairings, not puzzles.

The OS version decides the ROS distro — 24.04 means Jazzy, 22.04 means Humble. Darkstar Robotics encodes that once, so no new user ever has to learn it the hard way.

Operating System
Ubuntu 24.04
→
Middleware
ROS 2 Jazzy
→
Simulation
Gazebo Harmonic
→
Autopilot
PX4 SITL

The working stack today — it's the pairing running inside the Omega-Ubuntu prototype: Ubuntu 24.04.3 LTS, tuned to a 6.4-second boot with zero failed units, ROS 2 sourced and ready, PX4 simulation on top.

Operating System
Ubuntu 22.04
→
Middleware
ROS 2 Humble
→
Simulation
Gazebo
→
Autopilot
PX4 SITL

The next validated pairing, for the huge installed base still on 22.04 / Humble. Same rule as everywhere in Darkstar Robotics: you pick what you want to build — never which versions "go together."

A drone flight controller board on a dark workbench being photographed by a phone for identification
Photo intakeRecognition plugs in
Hardware

Start from what you own.

Most robotics tooling starts with a shopping list. Darkstar Robotics starts with your bench. Photograph a board, a flight controller, a label, a QR code — the fleet is built from the hardware already in front of you.

It's the input method nobody else ships: no catalog to scroll, no part numbers to memorize.

  1. 01
    Drop the photoA board, a controller, a shipping label, a QR code — any angle.
  2. 02
    Darkstar Robotics takes intakeThe hardware joins your fleet record, ready for environments and missions.
  3. 03
    Recognition plugs in behind itThe intake is live in v0.1; the recognition engine slots in behind the same door.
Mission

Evidence, not adjectives.

The golden demo isn't a render. It's a PX4 swarm-recovery flight with its numbers attached — and every status on this page is labeled for what it actually is: live, recorded, or pending. Green means verified.

PX4 Swarm Recovery

GOLDEN DEMO · SITL · 3 VEHICLES RecordedResult: Pass
Min separation — metres over flightSafety floor 5.0 m
14 10 6 T+0s T+END FLOOR 5.0 M MIN 8.095 M REASSIGNMENT 1 REASSIGNMENT 2
Verdict
PASS
Min separation
8.095 m
Telemetry samples
641
Reassignments
2
Replay
Viewer — Recorded
Download

Get the installer.

Darkstar Robotics v0.3.0 is out. Download the installer, open it, and it walks the app into place — logo, status check, and all.

Darkstar Robotics Installer

The installer GUI checks for an existing install, shows what it found, and installs Darkstar Robotics to your Applications folder in one click. Prefer to skip the installer? The app-only zip is the same build, ready to drag in yourself.

  • RequiresmacOS 14 or later · Apple Silicon
  • SigningUnsigned community build — on first launch, right-click the app and choose Open.
  • UpdatesThe app checks GitHub Releases for updates from Settings → Updates, only when you ask.
  • Releasev0.3.0 on GitHub ↗
Get it

Open Xcode. Press run.

v0.1 is public and source-available. Clone it, open the package, and the workstation is yours.

Terminal — zsh
# Clone Darkstar Robotics
$ git clone https://github.com/abelxmendoza/HangarBay.git
$ cd HangarBay

# Run it — or just open Package.swift in Xcode
$ swift run

# Settings (⌘,) holds the VM name + SSH target.
# → Dashboard live. Runtime probing…
  • macOS 14+ — Sonoma or laterHOST
  • Xcode — open Package.swift and press RunTOOLCHAIN
  • UTM — hosts the managed Linux runtimeRUNTIME
  • Tailscale — the link between GUI and guestLINK
  • Internal name — the Swift package is still RoboticsControlCenter; the product is Darkstar RoboticsNOTE
github.com/abelxmendoza/HangarBay ↗