Skip to main content

Documentation Index

Fetch the complete documentation index at: https://motorbridge.seeedstudio.com/llms.txt

Use this file to discover all available pages before exploring further.

Source: docs/en/distribution_channels.md

Distribution Channels (CI Automation)

This document describes the currently enabled additional package channel built on top of GitHub Releases and PyPI.

1) APT Repository (GitHub Pages)

Workflow: .github/workflows/apt-repo-publish.yml
  • Trigger:
    • on Release published
    • or manually (workflow_dispatch) with tag
  • Input assets:
    • *.deb from the tagged GitHub Release
  • Output:
    • APT repository published to gh-pages branch at /apt
    • URL pattern:
      • https://<owner>.github.io/<repo>/apt
Optional signing (recommended in production):
  • APT_GPG_PRIVATE_KEY (ASCII-armored private key)
  • APT_GPG_PASSPHRASE (if your key is passphrase-protected)
If no key is configured, workflow publishes unsigned metadata (-skip-signing).

Package Audience Mapping

Package / AssetIntended Developer TypeTypical Scenario
motorbridge-abi-<tag>-linux-x86_64.debC/C++ robotics developers on Ubuntu/DebianInstall ABI (libmotor_abi) + headers + CMake config for native integration
motorbridge-abi-<tag>-linux-*.tar.gz / windows-*.zipC/C++ developers on non-deb targets / custom toolchainsManual unpack and link in embedded or cross-compilation environments
motorbridge-*.whl / motorbridge-*.tar.gzPython application and tooling developersBuild robot apps, calibration tools, factory scripts with Python SDK
motor-cli-<tag>-<platform>.tar.gz/.zipTest/ops/factory engineersDirect motor scan/control without embedding SDK code
At this stage, Homebrew and Windows package-manager metadata automation were intentionally removed to keep the release process fully deterministic and fully automated in CI.