Open Source · Apache 2.0

AI Computer Control
from a Raspberry Pi

A hardware-level AI agent that controls any computer — without installing anything on it.

Works where no software agent can.

curl -sSL https://cyberraccoon.ai/install.sh | bash

Run on a Raspberry Pi · installs the package, walks you through hardware setup, registers the Web UI service.

Get Started View on GitHub
Star

How It Works

Capture. Think. Act.

CyberRaccoon runs on a Raspberry Pi connected to a target computer. It captures the screen, sends it to a vision LLM, and executes actions as real USB or Bluetooth HID input — just like a human sitting in front of the computer.

📸
Step 1

Capture

Screen is captured via HDMI-to-CSI bridge, USB HDMI card, Raspberry Pi camera, or wirelessly via AirPlay.

→
🧠
Step 2

Think

Screenshot is sent to a vision LLM (Anthropic, OpenAI, or compatible APIs) which decides the next action.

→
⌨️
Step 3

Act

The action is executed as real USB or Bluetooth HID input. The target sees a normal keyboard and mouse.

Control Interface

Manage tasks from your browser

A built-in web UI for remote task management, live screenshot preview, and real-time step logs.

http://raspberrypi:8000
CyberRaccoon ● Ready
Task Config Skills Status Debug
Screen Capture: AirPlay Connected
Mouse/Keyboard: Bluetooth Connected
Target OS: Auto-detect
Open Chrome and search for CyberRaccoon
Start
Live Screenshot Preview 1280 × 720
Step Log
#1 click (512, 48) 1.2s
#2 type "CyberRaccoon" 0.8s
#3 key enter 0.3s
#4 scroll down 0.5s
4 steps · 3.8s · 2,150 in · 680 out

Features

Everything you need

A complete system for AI-powered computer control, built for flexibility and reliability.

📸

4 Capture Sources

HDMI-to-CSI bridge (TC358743), USB HDMI capture card, Raspberry Pi CSI camera (picamera2), or wireless AirPlay mirroring. Pick what fits your setup.

🔌

2 HID Transports

Wired USB HID Gadget or wireless Bluetooth HID. Go fully wireless with AirPlay + Bluetooth.

🧠

Multiple LLMs

Anthropic, OpenAI, or any compatible API. Switch providers with a single flag.

🧑

Humanized Input

Bézier curve mouse movement, variable typing rhythm, and random jitter. Three presets: subtle, normal, aggressive.

🌐

Web UI + CLI

Manage tasks remotely via browser (FastAPI + WebSocket) or terminal REPL with autocompletion.

📚

Skills System

Application-specific knowledge files that teach the AI domain expertise — like Blender workflows or app-specific shortcuts.

Use Cases

Where software agents fail

CyberRaccoon operates at the hardware layer, so it works in scenarios that are impossible for any software-based agent.

01

Bare Metal & BIOS

Configure BIOS settings, install an OS from scratch, flash firmware. No operating system is running — no software agent can exist. CyberRaccoon walks through the entire process from power-on to desktop.

Impossible for software agents
02

Legacy & Locked-Down Machines

Factories running Windows XP, hospitals on ancient systems, air-gapped military networks, medical devices. Security policy forbids installing software — but they have a screen and a USB port.

Impossible for software agents
03

Anti-Detection Automation

Real USB HID hardware with humanized Bézier curves and typing rhythm. No browser fingerprint, no process to detect. Indistinguishable from a human to any detection system.

Advantage over software agents

Also great for

Boot Recovery Embedded & Kiosk UIs Cross-Platform Automation End-to-End Testing Remote IT Support

Hardware

What you need

A minimal shopping list to get started. Total cost under $120.

ItemCostRequired?
Raspberry Pi 5 🤎 Raspberry Pi 5 (or 4B) $60 – $80 Required
TC358743 HDMI-to-CSI bridge 📺 HDMI-to-CSI Bridge (TC358743) $15 – $25 Optional — best-tested capture path; uses the Pi’s CSI port, no USB needed
USB HDMI capture card 📸 USB HDMI Capture Card $10 – $20 Optional — alternative to the CSI bridge; not needed if using AirPlay
USB power/data splitter cable 🔌 USB power/data splitter cable $5 – $15 Recommended for USB HID — external power to the Pi, separate data cable to the target. Lets you swap the data cable to another target without power-cycling the Pi. A single USB cable (Pi USB-C to target USB-C or USB-A) also works — carries power + data, but the Pi may log under-voltage and changing target means powering off the Pi. Not needed at all if you use Bluetooth HID.
Minimum (Pi only) ~$60 AirPlay capture + Bluetooth HID — macOS targets only

Quick Start

Up and running in minutes

# One-command install on the Raspberry Pi.
# Clones the repo, sets up a venv, installs the package, walks you through
# hardware setup, and registers a systemd service that auto-starts the Web UI.
curl -sSL https://cyberraccoon.ai/install.sh | bash

# When it finishes it prints the URL — open it in your browser:
#   http://raspberrypi.local:8000
#
# 1. Status tab  → shows hardware setup status (re-run any missing piece from here)
# 2. Config tab  → paste your API key (saved to ~/.cyberraccoon/config.yaml, 0o600)
# 3. Task tab    → pick capture source + HID transport, type a goal, hit Start

# Prefer the command line? See docs/user-guide.md for CLI usage.

Disclaimer: CyberRaccoon is an experimental open-source project provided "as-is" under the Apache 2.0 License. It is not intended for production use. The authors are not responsible for any loss, damage, or unintended consequences resulting from the use of this software. Use at your own risk.