Skip to content

V0.3.2 · ANet4D

Choose a tag to compare

@inksong inksong released this 25 Oct 19:38
· 53 commits to main since this release

V0.3.2 · ANet4D

V0.3.2 renames the product (formerly ANet Drone4D) to ANet4D: simulation infrastructure for collaborative embodied agents. It also merges the scene-target foundations branch and seals the current version. The released capabilities are the same as V0.3.1: the interactive sandbox, the D2 world runtime and the D3 Event Lab. Drones are the first class of entity that is implemented. Collaboration across entity types (ground vehicles, surface vessels, fixed sensors and software agents) is the forward direction of the project and is not part of this release (docs/06).

Name and addresses

  • Product name: ANet4D. Releases up to V0.3.1 were published as ANet Drone4D. The rename is recorded in ADR-223 (docs/05).
  • Public site: https://anet4d.agentnetwork.org.cn. The former domain drone4d.agentnetwork.org.cn returns a permanent redirect (301) to the same path on the new domain.
  • Documentation: https://docs.agentnetwork.org.cn/anet4d/. Pages under the former /drone4d/ path redirect to the same page under /anet4d/.
  • Repository: the repository URL does not change in this release.
  • Header images: the README header, the social image and the landing page header use the new name.

Agent SDK

  • The package, import name and command line tool are now anet4d (pip install anet4d, python -m anet4d.serve, anet4d-agent). The SDK version is 0.3.2.
  • drone4d remains for one release as a deprecated alias. import drone4d resolves to the same modules and emits a DeprecationWarning, and python -m drone4d.serve and drone4d-agent print a notice. Agents built for V0.3.1 run without changes.

Scene-target foundations (experimental, off by default)

The collaborator branch m23/scene-target-foundations is merged (ADR-224). It adds scene-target appearance, activity plans for pedestrians and life recipes. With the default configuration nothing of it is reachable:

  • The server switch AWR_TARGET_LIFE_ENABLE (default off) controls the three experimental routes, which return 404 when it is off. It also controls the sandbox templates T7 to T13 and the reset of the slow-task simulation clock.
  • The public build switch VITE_AWR_TARGET_LIFE (default 0) removes the scenario designer and its texts from the public site.
  • Contracts move from 1.2.0 to 1.3.0 with new optional fields only (docs/17 §18.25). Layouts and the realtime subprotocol are unchanged.
  • Activity plans draw from a registered random stream (stream 24, target_activity). Stream 23 is reserved for D4.

The branch also brings these sandbox fixes, which are active in all builds:

  • The mobile layout no longer stalls at start-up when the viewport is hidden.
  • Camera tracking releases correctly.
  • Target configuration is cleared when the session epoch changes, and is retried while the REST service is starting.
  • "Add target" is disabled until the configuration has loaded.
  • The session bar can resume a sandbox.

Compatibility

These identifiers keep their names as legacy identifiers:

  • protocol and schema identifiers (drone4d.bench.wire.v1, drone4d.event.v1 and others)
  • the DRONE4D_* environment variables and the agent socket path
  • native Gazebo plugin names
  • server install paths and service unit names

Recorded tapes, runs and submissions from V0.3.x remain valid.

Verification

  • The D3 regression gate ran on the release tree (tree 95a3f4890b83). Contracts, web unit tests, lint, the public build, the K9 checks and the lab build passed. On the CPU pool, the full D2 Python suite, the zero-impact replay comparison (relay_batch --determinism), the resimulation check and the import check passed.
  • The performance step was not judged: the shared CPU pool host ran at about 0.62 load per CPU during the gate, above the 0.5 limit. The changes in this release do not touch the simulation hot path; they rename the product, and the new code is behind switches that are off by default. The performance measurement is carried as an open item and will be repeated when the host is idle.
  • Demo build parity is rebaselined to v0.3.2. The public build differs from V0.3.1 by the new name and the sandbox fixes listed above.

Assets and attribution

The world model "oryahovo - crop #1 - metashape texture problems" is by Mitko (https://sketchfab.com/bg3d) and is used under CC BY 4.0, modified. Sample media, slices and the Rerun Web Viewer module are served from the ModelScope dataset inksong/ANet-Drone4D-samples (CC BY 4.0). The dataset keeps its name in this release.

Known issues

  • The public host has limited outbound bandwidth (about 3 Mbps, measured on 2026-10-25 from Ningbo and from the United States over the public internet), so large media is served from ModelScope.
  • The redirect pages under the former documentation path cover HTML pages only.
  • Building from the v0.3.2 tag on a clean checkout: make setup fails because apps/web still pins @awr/contracts 1.2.0 (the workspace package is 1.3.0), and make build reports a false finding in the production bundle scan. Both are fixed on main (9898185, 6f55081); build from main or apply these two commits. The deployed public build is not affected.