Releases: HKUOpenSource/OpenAirTwin
Release list
OpenAirTwin v1.0.0
OpenAirTwin v1.0.0 is the first stable software release of the modular OpenAirTwin platform.
Highlights
- Explicit frontend and backend Feature registries for Link, Mobility, Radiomap, and DeepMIMO.
- Feature-owned state, transport, lifecycle, and renderer modules.
- Shared viewer layers, primitives, model asset management, and in-process job infrastructure.
- Cross-platform installer improvements and Windows environment support.
- New Python, Playwright, tutorial, and GitHub Actions release gates.
- Interactive architecture documentation and improved tutorial accessibility.
Compatibility
- Existing REST URLs, status codes, JSON fields, polling behavior, and synchronous/asynchronous semantics are preserved.
- Existing main application DOM IDs, control order, interaction flow, and Three.js output remain compatible.
- Existing global state, API exports, and Viewer methods remain available as compatibility facades.
Installation
Follow the Quick Start or the video tutorial.
The sample scene remains a separate data Release. python3 install.py --with-sample-scene continues to download the pinned sample-scene asset.
Validation
- Python unit and contract suite: 193 tests
- Playwright full suite: 5 tests, including four macOS visual snapshots
- Deterministic CI browser contracts: 4 tests
- Tutorial contracts: 20 clips with captions, accessibility, and navigation checks
- Tutorial TypeScript check and production build
- CFF metadata parse and release consistency checks
See the full Changelog.
OpenAirTwin sample scene
Sample scene data for first-run OpenAirTwin testing.
Download OAT-Sample-Scene.zip from the release assets. The automatically generated Source code downloads are GitHub repository snapshots and do not contain the sample scene data.
This package includes four Open3Dhk tiles:
11_SW_7A11_SW_7B11_SW_7C11_SW_7D
Extracted data is installed under scene/ and includes the runtime scene XML and mesh files needed by OpenAirTwin. Frontend render caches are rebuilt locally when needed.
Data source: Hong Kong Lands Department / Common Spatial Data Infrastructure (CSDI) / Open3Dhk.
The sample scene data is third-party government spatial data and is not licensed under OpenAirTwin's Apache-2.0 software license. See THIRD_PARTY_DATA.md inside the archive for attribution and data-use details.