Skip to content

N3 AI Deck v0.3.0

Latest
Latest

Choose a tag to compare

View all tags
@jincai822 jincai822 released this 08 Aug 14:49
· 3 commits to main since this release
v0.3.0
d27e6f2

N3 AI Deck v0.3.0

The first N3 AI Deck release to ship the G8 background service. n3-ai-deck-service turns the validated live-dispatch path into a systemd user service: plug the device in and it reconnects, backs off, and dispatches — no foreground terminal required. Forked from asad-albadi/streamdock-n3 (MIT, Copyright (c) 2026 Asad Al Badi) — upstream lineage (through 0.2.5) is recorded in the CHANGELOG; 0.1.0 was the first version published by this fork and 0.3.0 is this release. 0.2.0 was skipped to avoid colliding with the upstream project's v0.2.0–v0.2.5 release pages, which this repository still hosts; 0.3.0 logically follows that lineage.

What's new in v0.3.0

  • Background service (G8) — n3-ai-deck-service: systemd user service with in-process reconnect and capped back-off (2 s → 5 s → 10 s → 30 s), bounded live sessions, a clean SIGTERM stop, and journald-ready logging
  • Owner-gated installers — --print-unit prints the systemd user unit; --print-udev-rule prints the udev rule for automatic uaccess permissions. Both print only and never install anything
  • Udev rule auto-permissions — install the printed 60-n3-ai-deck.rules (USB-device-level match + uaccess tag, sorting before 73-seat-late.rules), reload and trigger, and the device nodes grant access automatically in an active desktop session
  • Three validation-hardening fixes:
    • permission-rejected sessions now back off instead of hot-looping
    • stdout is line-buffered at CLI startup so journald receives log lines immediately
    • the generated udev rule matches at the USB device level only — a rule's ATTRS{} matches one parent device, so the interface attributes were never combinable in one line

Hardware-validated on the owner's 6602:1000 unit (P5 owner-present record in docs/validation/): unplug/replug recovery with the observed back-off sequence, a real self-install via uv tool install with the stock unit running under systemd, and the automatic uaccess end-to-end test that passed before and after a cable replug with no manual permissions. 996 tests green.

Install

From PyPI (recommended):

pip install streamdock-n3-linux

Or from the GitHub Release assets:

pipx install https://github.com/jincai822/n3-ai-deck/releases/download/v0.3.0/streamdock_n3_linux-0.3.0-py3-none-any.whl

For the background service (print the owner-gated assets, then install them yourself):

n3-ai-deck-service --print-unit > ~/.config/systemd/user/n3-ai-deck.service
n3-ai-deck-service --print-udev-rule | sudo tee /etc/udev/rules.d/60-n3-ai-deck.rules
sudo udevadm control --reload && sudo udevadm trigger
systemctl --user daemon-reload
systemctl --user enable --now n3-ai-deck

Verify artifact integrity against SHA256SUMS attached below.

Not in v0.2.0

  • GUI configuration, entry-point plugin discovery
  • PyPI trusted-publishing automation (the manual PyPI upload is live: https://pypi.org/project/streamdock-n3-linux/)
  • The legacy upstream console scripts (streamdock-n3, -gui, -probe, -debug) still ship but are upstream legacy, not part of the validated N3 AI Deck path

Open legal note

The vendored StreamDock SDK has no bundled license file; commercial redistribution review remains open (tracked in the PRD). This release is open-source under MIT, consistent with upstream's own distribution.

Assets 5
Loading