> For the complete documentation index, see [llms.txt](https://docs.theseus.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseus.us/cyclops/getting-started.md).

# Getting Started

Cyclops is a visual positioning system (VPS) for UAVs operating in GPS-denied environments. It delivers drift-free global position estimates using onboard camera imagery. Cyclops runs on commercial hardware, works day or night, and integrates directly with ArduPilot.

<figure><img src="https://content.gitbook.com/content/hzvlBbeiwnrjdGDAaBcQ/blobs/iUcfCp6ASGijsuTTcKwO/Screenshot%202026-08-03%20091007.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The best way to get started with Cyclops is with a **Preconfigured Cyclops System**.&#x20;

Reach out to <inbound@theseus.us> to get one.
{% endhint %}

## Before starting

This quick start guide walks you through setting up Cyclops on your drone. By the end you'll be ready to perform bench tests and run your first flight with Cyclops.

**On the drone:**

* ArduPilot v4.5+ with compass, barometer, IMU
  * On fixed wing, it is preferred to have an airspeed sensor
* Camera (EO or thermal), ≥0.05MP resolution, global shutter is optimal, rolling shutter is ok
* ARM64 edge computer: 2+ cores @ 2.4GHz, 2GB RAM, Ubuntu 22/24
  * Tested: Raspberry Pi 5, NanoPi R6C
* MAVLink connection (UART or UDP) between flight controller and edge device

**On the ground:**

* GCS computer running Linux or Windows

{% hint style="info" %}
Learn more about supported hardware [here](/cyclops/prerequisites.md#computer-requirements).
{% endhint %}

## Software setup steps

The following steps describe the Cyclops software setup process. For information on installing Cyclops hardware on your drone, check out [UAV Integration](/cyclops/uav-integration.md).

1. [Create a Theseus account](https://dashboard.theseus.us/signup)
2. [Install Vozilla](https://dashboard.theseus.us/downloads)
3. [Set up edge device OS with SSH](/cyclops/cyclops-computer/example-pi-5-setup/ubuntu-and-sd-card-setup.md)
4. [Configure edge device serial and storage](/cyclops/cyclops-computer/example-pi-5-setup/hardware-configuration.md)
5. [Install Cyclops](/cyclops/cyclops-computer/example-pi-5-setup/vns-sdk-setup.md)
6. [Connect to Cyclops with Vozilla](/vozilla-gcs-software/vozilla-app/quick-start.md#connecting-to-micro-vps)
7. [Configure Cyclops with Vozilla](#add-your-vehicle)
8. [Calibrate camera](/cyclops/uav-integration/camera-calibration.md)
9. [Generate map](/vozilla-gcs-software/vozilla-app/maps/creating-maps.md)
10. [Set ArduPilot params](#update-ardupilot-parameters)
11. [Bench test the system](/cyclops/system-validation/bench-test.md)