Skip to main content

Install visio-schema (Python)

visio-schema is the Python package for parsing EGO1 data — from .mcap recordings or live streams.

Install​

Install directly from the GitHub release (current version 0.2.0):

pip install https://github.com/General-Intelligence-Labs/visio-schema/releases/download/v0.2.0/visio_schema-0.2.0.tar.gz

Or download the source dist from Downloads and install the local file:

pip install visio_schema-0.2.0.tar.gz

It includes the dependencies it needs by default (protobuf / cobs / mcap / pyserial / foxglove-sdk / rerun-sdk / av) — no extra extras required. Installing also provides the visio-display command-line tool (see visio-display CLI).

Read data in Python​

from visio_schema import read_mcap

# Read a recording offloaded from the MicroSD card (or via the app)
for msg, channel in read_mcap("capture.mcap"):
    if channel.topic == "/ego/imu/0/quat":
        print(msg)          # decoded protobuf message

For a live stream, EGO1 exposes data over Wi-Fi (TCP 192.168.4.1:50001) — use visio-display --tcp to record it to an .mcap or bridge it into Foxglove, then read the .mcap as above. (USB-C on EGO1 is power only today; a USB data link is coming in an upcoming release.)

Stable API surface​

Beyond read_mcap, the package exposes:

  • McapWriter(path) — write recordings.
  • ChannelRegistry — channel/schema registry.
  • message_class(schema_name) — resolve a message class by schema name.

For the list of topics and schemas you'll encounter, see Data streams and the channel & network reference.