cameo github

any AMD card.
serves LLMs.

Flash Cameo to a USB, boot an AMD machine, and open the local web app. Models run offline.

RX 580RX 68007900 XTXMI210APUs
Download Cameo

Free • Open source • Apache 2.0

GitHub

01how it works

Four steps. Then it’s local.

01

Download

One bootable ISO.

02

Flash

Write it to USB.

03

Boot

Install on the AMD box.

04

Open

cameo.local:9090

02what your card does

Three tiers. Vulkan on all of them.

Tier 1

Train + Serve

7900 XTX · MI210

train
serve

Tier 2

Serve

RX 6800 · 6700 XT

train
serve

Tier 3

Vulkan Inference

RX 580 · APUs

train
serve

03the console

Administer it from a browser.

04the Deck

Model. Owner. Proof.

RUNNING

Model status

/v1 · serving
MEMORY

Capacity

18.2 GB · available
RESULT

Verification

12 checks · passed
ACCESS

Permissions

scoped keys
API contract
  Cameo Engine Contract v1
consumer  GET /api/engines  -> models, profiles, limits, capabilitiesconsumer  POST /v1/chat/completions  -> OpenAI JSON + SSE streamingoperator  POST /api/servers  -> deliberately provision a cold modelsession   POST /api/sessions/{id}/lease  -> protect a running modeltools     agent-managed fallback  -> no assumed server-specific dialectCameo observes the work. Daedalus owns the agent loop.

05one card → a cluster

Same two commands on 1, 4, or 9 cards.

one card ×1 a box ×4 a cluster ×9 one card ×1 a box ×4 a cluster ×9

06get it

Image. Flash. Done.

flash cameo-*.iso → boot Install Cameo to disk → chat cameo.local:9090
Daedalus standalone for Windows

Standalone harness

Run the Rust-native daedalus harness on an existing Windows workstation with the validated archive below. Verify the archive before opening it.

Windowsx86_64

Standalone daedalus.exe plus documentation.

Download Windows zip

SHA-256 checksum

Linux + macOScoming later

Packages will appear here after their release builds pass validation.

Installation guide · USB to local chat · erases the selected disk

2 · Flash a USB

Windows: Rufus in DD Image mode (ISO mode often will not boot), or Etcher. Linux/macOS: Etcher, or:

sudo dd if=cameo-*.iso of=/dev/sdX bs=4M status=progress oflag=sync

3 · Plug it in, set an account

Disable Secure Boot (or the stick is ignored and Windows boots). Put the USB in the AMD machine. Install Cameo to disk is already the default entry. It shows the detected GPU and tier, then asks for:

which disk to erase admin username admin password

Nothing is downloaded. The installer copies the live image onto that disk, writes a console key, and enables cameod. Then reboot and pull the USB.

4 · Play, offline

From a laptop or phone on the same LAN (plug the box into Ethernet if it has a port), open the URL printed after login — http://cameo.local:9090 or the IP. Enter the key. Start qwen2.5-0.5b (smoke test, already on disk). Chatting never phones home. Extra GGUFs: drop them in /var/lib/cameo/models.

Fleet: that’s when you connect Wi-Fi

A single box does not need Wi-Fi. Join a fleet of nodes — then give that node a network so it can attach:

Ethernet — plug in, DHCP is automatic Wi-Fi — iwctl on that node only extra models — cameo pull 
iwctl
  station list
  station wlan0 scan
  station wlan0 get-networks
  station wlan0 connect 'YourSSID'

Then cameo fleet / hub URL on that node. One machine, one card, one house: stay air-gapped after you flash.

Developers: container or build the ISO yourself

Container — host owns the GPU driver:

podman build -f containers/Containerfile -t cameo:vulkan .
podman run --rm -p 9090:9090 \
  -v cameo-models:/var/lib/cameo/models \
  --device=/dev/kfd --device=/dev/dri \
  --group-add video --group-add render \
  cameo:vulkan

Build the ISO on an Arch host:

git clone https://github.com/sadlowskik/Cameo
sudo ./scripts/build-iso.sh
sudo CAMEO_EDITION=lite ./scripts/build-iso.sh

Beta, pre-v1. Flash an .iso, not Source code. Check SHA256SUMS. The disk installer erases the drive you pick. Source: github.com/sadlowskik/Cameo.