Documentation
Haiku’s API, and what air/OS adds.
Write native apps for air/OS with Haiku’s API. These pages show where the fork differs from Haiku, kit by kit, with links back to Haiku’s own reference. The new Neural Kit is covered in full.
Start with Haiku’s reference
air/OS is built on Haiku, and Haiku’s documentation describes almost all of its API. These pages do not repeat it. They cover what the fork adds or changes, kit by kit, and document in full the one kit that is new: the Neural Kit.
What air/OS adds
New kitNeural KitRun neural networks on NPUs, graphics processors and the CPU through one API, and turn speech into text on the machine itself.Guide, reference and examples →45 changesKit differencesEvery public API the fork adds or changes, shown as a diff against Haiku, plus behaviour changes and the private APIs system apps use.Kit by kit →
To try your app, or air/OS itself, without a spare computer, run it in a virtual machine: QEMU and UTM set-up →
Kit by kit
| Kit | What changed | Changes |
|---|---|---|
| Interface Kit | Most of the fork's API work is here: fractional scaling, frame-accurate presentation, dark mode and colour emoji, plus a private accessibility interface. | 6 added 3 behaviour 2 private |
| Application Kit | No public header changes. Notifications can now answer the app that posted them, and there are new system protocols for media keys and shutdown. | 1 behaviour 2 private |
| Game Kit | BDirectWindow works on a scaled desktop, in the frame buffer's own pixels. | 1 added 1 changed |
| Media Kit | No public header changes. Device selection, default-change notifications and recording now work as documented, and a private now-playing library was added. | 3 behaviour 1 private |
| Device Kit | Game pad rumble, gap-free isochronous USB input, and a class for small auxiliary displays. | 3 added |
| Network Kit | Link speed, a Wi-Fi password parameter, a service order for the default route, and .local names. | 2 added 2 behaviour 1 private |
| Bluetooth Kit | Bluetooth Low Energy, Secure Simple Pairing events, link policy and A2DP audio. The Haiku Book does not document the Bluetooth Kit; Haiku's headers are the reference. | 3 added 1 private |
| Support Kit | One fix to an inline function that matters on ARM64. | 1 changed |
| Storage Kit | No public header changes. | 1 behaviour |
| Package Kit | No public header changes. | 1 private |
| Tracker Kit and Quick Look | A public add-on API for Quick Look previews, plus private protocols for network shares and the Deskbar. | 1 added 1 private |
| Graphics drivers (accelerants) | Optional hooks for several monitors on one device, per-monitor blanks, device-side copies to the screen, and resume. | 3 added |
| Device drivers | Power management for suspend, more PCI host topologies, USB device speed and keep-awake, and USB Audio 2.0 descriptors. | 5 added |
| Neural Kit | New in air/OS: inference on NPUs, GPUs and the CPU, and speech recognition. | new kit |
Compatibility
- Apps built for Haiku run on air/OS unchanged. No class gained a virtual function or changed size; new structure fields use reserved space.
- Apps that use these additions need air/OS. air/OS defines no compiler macro of its own. A kit that is new can be detected with
__has_include(<NeuralKit.h>); additions to existing classes cannot, so build such apps for air/OS, as Summit ships separate builds for air/OS and stock Haiku. - Private headers may change. APIs marked Private are what the system’s own apps use. They are listed so you know they exist; there is no promise they stay as they are.
- Headers and libraries come with the system’s development package, as on Haiku: the headers in
/boot/system/develop/headers, the libraries to link with in/boot/system/develop/lib.
