Skip to content

OneNoted/inspectors

Repository files navigation

Agent Computer Use Platform

A desktop automation platform for AI agents that need a real Linux session.
QEMU/KVM first in production, with an honest Xvfb fallback for local development and verification.

Status: alpha CI License Rust 1.85+ Bun 1.3.11

Agent Computer Use Platform showing a live Linux desktop session with operator tooling

Getting started · Documentation · API reference · Architecture

Agent Computer Use Platform gives agents a real Linux desktop to work in, with screenshots, shell access, files, desktop input, and an operator view that makes the current session state easy to follow.

What it does

  • Runs agent tasks inside disposable Linux sessions instead of collapsing everything into a browser tab.
  • Gives you one place to work with screenshots, shell commands, files, desktop input, and session state.
  • Keeps operators in the loop with a live desktop view, structured receipts, and clear fallback modes.

Quickstart

bun ci
bun run build
bun run --filter @acu/sandbox-runner start

Open http://127.0.0.1:3000, create a session, and drive it through the control plane or the SDKs. For the full local setup, smoke eval, examples, and install notes, start with the getting started guide.

Prefer Nix on Linux? This repo now ships a flake for the reproducible source-first path:

nix develop
bun run build
nix build .#guest-runtime

You can also install the Rust binaries directly from the flake with nix profile install .#guest-runtime or nix profile install .#export-schemas.

On Arch Linux, the packaged desktop app is also available through the AUR with paru:

paru -S inspectors-desktop-bin
# or build from source packages instead:
paru -S inspectors-desktop
paru -S inspectors-desktop-git

Use the AUR packages when you want the packaged desktop app on Arch. For source checkouts, local builds, and the full development stack, keep following the getting started guide. The AUR packaging source of truth lives under packaging/aur.

Documentation

Status

Alpha. QEMU/KVM is the product path; Xvfb stays in the repo as the lighter local fallback and regression lane.

License

MIT. See LICENSE.

About

Give your agents the ability to verify their work through their very own Virtual Machine

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors