Quick Start

Get up and running with Cyberwave in just a few minutes

Cyberwave is in Private Beta.

Request early access to get access to the Cyberwave dashboard.

Try a Real Robot Live

Get hands-on with Cyberwave in under 2 minutes; no setup, no hardware, no code. Control a real SO101 robot arm live in our robotics lab from your browser.

1. Sign up for Cyberwave

   Create an account at cyberwave.com or request early access if you don’t have one yet.

2. Click 'Try a Real Robot'

   From the dashboard, click Try a Real Robot. You’ll be connected to a live SO101 robot arm with a camera in the Cyberwave robotics lab.

   
3. Control the robot (Switch to Live Mode)

   A keyboard controller is already assigned, start moving the arm immediately in the live mode from your browser. You’ll see the live camera feed from the lab as you control the robot in real time.

   

What’s connected:

The live demo environment has an SO101 robot arm with a camera mounted on the wrist, streaming directly from the Milan lab.

What you can do:

• Control the arm: a keyboard controller is pre-assigned, use it to move individual joints in real time
• Watch the live camera feed: see what the robot sees from the wrist-mounted camera in the Milan lab
• Record datasets: start a recording session to capture arm movements and camera footage, just like you would in your own setup
• Want a specific use case? reach out to the team and we can configure a custom demo for your needs

You’re controlling a physical robot from your browser. Everything you see here, joint control, camera streaming, dataset recording is the same experience you get with your own hardware.

---

Build Your Own Setup

Ready to go beyond the demo? This guide takes you from zero to a working Physical AI application. You will:

1. Create a virtual environment and add a digital twin of your robot
2. Build applications using the Python SDK, MCP server, or REST API from your laptop, with no hardware required
3. Connect real hardware so the same code drives a physical robot

Part 1: Develop in Simulation

Start here. No hardware required.

Step 1: Create an Environment

An environment is a 3D virtual space that mirrors your real-world robot setup. It’s where your digital twins live, sensors stream data, and controllers send commands, all in real time.

1. Go to the Cyberwave dashboard and click New Environment.
2. Give your environment a name and description.

---

Step 2: Add a Digital Twin

A digital twin is a virtual replica of your physical robot, it mirrors the robot’s structure, joints, sensors, and behavior in real time within your environment.

1. Inside your environment, click Add from Catalog in the left panel.
2. Browse the catalog, find your robot, and add it to the environment.
3. Position the twin to match your physical setup.

Browse Catalog

Explore our robot catalog

---

Step 3: Build Your Application

With your environment and digital twin ready, you can start building immediately. Your application code runs anywhere, laptop, cloud server, CI pipeline and talks to Cyberwave Cloud over the API.

Python SDK

Control twins, capture frames, trigger workflows, and manage infrastructure programmatically

MCP Server

Let AI agents (Claude, GPT, Cursor) manage your robotics setup through natural language

REST API

Direct HTTP access to every Cyberwave operation from any language

Install the Python SDK on your development machine:

pip install cyberwave

Generate an API key at Dashboard → Profile → API Keys and export it:

export CYBERWAVE_API_KEY=your_api_key

---

Step 4: Control Your Twin in Simulation

You can control your digital twin in simulation in two ways: through the dashboard UI or through code.

Dashboard UI

Control your twin directly from the Cyberwave platform, no code needed.

1. Open your environment in the Cyberwave dashboard.
2. Switch to Simulation mode.
3. Click the Assign Controller button on your twin.
4. Select a controller from the list, for example:
   • Keyboard: control individual joints using keyboard keys
5. Start moving the twin using the assigned controller. You’ll see the digital twin responding in the 3D environment in real time.

Your twin is being controlled in simulation. Use this to explore how the robot behaves before writing any code or connecting real hardware.

Python SDK

Run this from your laptop, no physical robot needed. Use affect("simulation") to make your actions impact the digital twin instead of live hardware.

from cyberwave import Cyberwave

cw = Cyberwave(api_key="your_api_key")
cw.affect("simulation")

robot = cw.twin("the-robot-studio/so101")

robot.edit_position(x=1.0, y=0.0, z=0.5)
robot.joints.set("shoulder_joint", 45, degrees=True)

frame = robot.capture_frame("numpy")

Open the Cyberwave dashboard, you should see your twin moving in the environment as the script runs.

Your application is running against a live digital twin in simulation. Iterate freely here before touching real hardware.

Use cw.affect("simulation") while building against the digital twin, then switch to cw.affect("live") when you’re ready for the physical robot.

---

Part 2: Connect Real Hardware

Once your application works in simulation, connect it to the physical robot. These steps run on the machine that is physically connected to the robot, an edge device (Raspberry Pi, Jetson) or your laptop if the robot is plugged in directly via USB.

If you’re only working in simulation or building application code, you can skip Part 2 for now and come back when you’re ready to connect hardware.

Step 5: Install the Cyberwave CLI

The Cyberwave CLI and Edge Core require a 64-bit architecture (arm64/aarch64) on Raspberry Pi. If you are using a 32-bit OS or architecture, please wait for an updated version.

Remote Edge Device (Raspberry Pi, Jetson, etc.)

SSH into your edge device:

ssh <edge-device-username>@<edge-device-ip>

Then install the CLI:

curl -fsSL https://cyberwave.com/install.sh | bash

Robot Connected Directly to This Machine

If your robot is connected via USB or serial (e.g. an SO101 arm plugged into your laptop), install the CLI on the same machine:

curl -fsSL https://cyberwave.com/install.sh | bash

---

Step 6: Install the Edge Core

The Edge Core runs on the robot’s machine and bridges your physical hardware to the Cyberwave cloud.

sudo cyberwave edge install

The CLI will prompt you to log in and install cyberwave-edge-core.

---

Step 7: Pair Hardware with the Digital Twin

Follow the prompts in your terminal:

1. Select the environment you created in Step 1.
2. Select the digital twin you added in Step 2.
3. The appropriate driver will be automatically installed and configured for your robot.

Your physical robot is now paired with its digital twin and syncing in real time.

Your application code from Part 1 now drives the physical robot. Switch the SDK to live control so your actions affect the real robot:

cw = Cyberwave(api_key="your_api_key")
cw.affect("live")

---

Next Steps

Architecture

Understand the full system architecture

Python SDK

Full SDK reference and examples

MCP Server

Let AI agents manage your infrastructure

SO101 Robot Arms

Set up teleoperation and datasets

UGV Beast

Get started with the UGV Beast

Unitree Go2

Connect the Go2 quadruped