🔧

AI PC Technician

AI-guided system diagnosis and repair — plus a USB device profiler that reverse-engineers hardware protocols and generates Linux kernel drivers automatically.

🔬 Hardware profiling 🐧 Kernel module generation 🌐 Remote via Tailscale ⚡ ARM cross-compile

AI-Guided System Repair

The AI follows a structured surgical protocol — diagnose before touching, verify at every step

# Chameleon AI diagnosis sequence $ lsusb -v | head -80 Bus 002 Device 003: ID 0bda:8153 Realtek USB 10/100/1000 LAN $ dmesg | tail -30 [12.445] r8152 2-1:1.0 eth1: renamed from eth0 $ lsmod | grep r8152 r8152 94208 0 $ modinfo r8152 | grep version version: v1.12.13
🔍

Structured diagnosis sequence

Hardware → kernel state → driver status → network → storage. The AI runs each step, reads the JSON result, then decides the next action. It never skips steps or makes assumptions.

🏥

Surgical repair protocol

Non-destructive first (reload module, restart service). Persist before risk (snapshot config). Verify at each step. Every reboot-requiring action triggers a Dead Man's Switch that sets a @reboot resume script automatically.

🌐

Remote repair over Tailscale

Diagnose and repair machines anywhere on your Tailscale mesh. The AI issues commands on the remote machine via the terminal bridge, reads results and continues — even across reboots using the checkpoint/resume system.

USB Driver Porter

Profile any USB device → analyse its protocol → generate a ready-to-install Linux driver

Path A

Standard protocols

No vendor pages found. Generates udev rules + modprobe config. No compilation required. Works with HID, CDC, mass storage and other standard classes.

udevmodprobe
Path B

Partial vendor protocol

Vendor pages detected (≤2). Generates a hidraw/uhid userspace daemon or ALSA plugin. Runs in user space — no kernel compilation needed.

hidrawALSA plugin
Path C

Proprietary protocol

Fully custom protocol. Generates a complete kernel module with DKMS packaging and ARM cross-compile support for Raspberry Pi 3, 4 and 5.

Kernel moduleDKMSARM

Profiler Workflow

# Step 1 — profile the device (30-second capture) $ python3 device_profiler.py --vid 0x1234 --pid 0x5678 --capture 30 Profiling USB 1234:5678 for 30s... Wrote ~/.chameleon/drivers/1234_5678/profile.json # Step 2 — generate the driver $ python3 device_porter.py --latest Path selected: C (proprietary, 3 vendor pages) Generated: /tmp/driver_1234_5678/ ├── chameleon_1234_5678.c ├── Makefile (cross-aarch64, cross-armv7) ├── install.sh ├── test_device.sh └── analysis.json # Step 3 — install $ sudo bash /tmp/driver_1234_5678/install.sh $ bash /tmp/driver_1234_5678/test_device.sh PASS — device /dev/chameleon0 responds correctly
🖥️

Cross-platform capture backends

ETW on Windows, IOKit on macOS, usbmon on Linux. Profile on any OS and generate a Linux driver from the resulting profile.json.

🍓

Raspberry Pi cross-compile

Makefile targets cross-aarch64 (Pi 4/5) and cross-armv7 (Pi 3) are included automatically in Path C. Build on x86 and deploy to ARM.

📦

DKMS packaging

Path C drivers are packaged for DKMS so they survive kernel upgrades without manual recompilation. The AI reviews analysis.json and prompts for any remaining TODO stubs.

Fix the unfixable

Whether it's a kernel panic, a dead USB device or a proprietary peripheral with no Linux support — Chameleon AI PC Technician has you covered.

Get in touch ← Back to overview