Skip to content

Releases: HKUOpenSource/OpenAirTwin

OpenAirTwin v1.0.0

Choose a tag to compare

@zhaolin820 zhaolin820 released this 19 Jul 11:23
03edaf2

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

Choose a tag to compare

@zhaolin820 zhaolin820 released this 20 May 12:42
442a428

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_7A
  • 11_SW_7B
  • 11_SW_7C
  • 11_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.