Skip to content

Setup: environment baseline and platform abstraction #340

Description

@rishika-y-gaur

Set up a working WSL2 environment on target Intel hardware, establish what the platform supports, and make the repo run unmodified on both Linux and WSL2.

Investigation

  • Set up Windows 11 + WSL2 + Ubuntu 24.04 + Docker Desktop (WSL2 backend). Document BIOS virtualization settings, WSL kernel version, and .wslconfig memory/CPU allocation
  • Determine whether OpenVINO can enumerate and use the Intel GPU inside a WSL2 container
  • Determine whether GStreamer VA-API hardware video decode works under WSL2. This is a different stack from OpenVINO GPU inference and must be tested separately
  • Determine whether the Intel NPU is reachable under WSL2
  • Investigate a GPU telemetry replacement for qmassa, which depends on DRM drivers that do not exist under WSL2

Platform abstraction

  • Add platform detection exposed to both the Makefile and the shell scripts
  • Add a WSL2 Docker Compose override with the correct device and volume mounts for WSL
  • Have the Makefile select the WSL override automatically
  • Replace hardcoded GPU device paths with a single resolver
  • Make video/render group lookups conditional, with safe defaults on WSL2
  • Fix host IP resolution so the MinIO and RabbitMQ UIs are reachable from a Windows browser
  • Support render mode through WSLg
  • Fix volume permissions and UID/GID handling under Docker Desktop

Expected done results

  • Working WSL2 environment; docker run hello-world passes; baseline config captured
  • Yes/no with evidence for GPU passthrough, hardware decode, and NPU support, with the required mounts documented where supported
  • Telemetry recommendation with a proof-of-concept sample
  • make run-lp works unmodified on Linux and WSL2, including render mode
  • Web UIs reachable from Windows; no permission errors after a run
  • Linux behaviour unchanged throughout

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions