> For the complete documentation index, see [llms.txt](https://danpeled.gitbook.io/synapse/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://danpeled.gitbook.io/synapse/readme.md).

# Home

<figure><img src="https://410957686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJwqHYWat9Tvb0ZO3Evhy%2Fuploads%2Fgit-blob-847e5292a9056af72592715ea3dd8d01fc655e11%2FSynapseHeader.png?alt=media" alt=""><figcaption></figcaption></figure>

Synapse is a vision processing library and toolset for [FRC](https://www.firstinspires.org/robotics/frc). It lets you run computer vision on a small Linux computer (a **coprocessor**) attached to your robot, then use the results in your robot code.

If you have never used Synapse before, start with [How Synapse Works](https://danpeled.gitbook.io/synapse/getting-started/how-synapse-works.md) and then follow the [Quick Start](https://danpeled.gitbook.io/synapse/getting-started/quick-start.md).

{% hint style="info" %}
The current pre-release is `2027.0.0a1`, built for WPILib 2027 alpha 8. See the [2027 alpha release notes](https://github.com/DanPeled/Synapse/releases/tag/v2027.0.0a1) for the full change list and prebuilt device images.
{% endhint %}

## What you get

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Extendable</strong></td><td>Use the built-in AprilTag, color, and object-detection pipelines, or write your own Python pipeline</td><td><a href="https://410957686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJwqHYWat9Tvb0ZO3Evhy%2Fuploads%2Fgit-blob-e3b13e3a82bc8a150439614ffaf783c3cf2ce7f7%2Fsettings.png?alt=media">settings.png</a></td></tr><tr><td><strong>Fast to iterate</strong></td><td>Deploy your vision project to the coprocessor like robot code, with one command</td><td><a href="https://410957686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJwqHYWat9Tvb0ZO3Evhy%2Fuploads%2Fgit-blob-1257dcb0ed1c07fac7936490724fe256af5965f6%2Frush.png?alt=media">rush.png</a></td></tr><tr><td><strong>Built-in UI</strong></td><td>Tune settings, watch camera streams, and inspect results live from a web browser</td><td><a href="https://410957686-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJwqHYWat9Tvb0ZO3Evhy%2Fuploads%2Fgit-blob-46f8f92e33d0ae0f2a549e11cb17e53e99d96197%2Fux-design.png?alt=media">ux-design.png</a></td></tr></tbody></table>

## The pieces of Synapse

| Piece                              | What it does                                                                                       | Runs on                         |
| ---------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Synapse runtime** (`synapsefrc`) | Reads cameras, runs pipelines, and publishes results                                               | Coprocessor                     |
| **Web UI**                         | Live camera feeds, pipeline management, settings, logs, and device controls                        | Any browser on the same network |
| **SynapseLib**                     | A Java/Python library that reads results and changes settings from robot code                      | Robot controller                |
| **Synapse Manager**                | A desktop app that finds devices, opens their dashboards, and deploys projects                     | Your development computer       |
| **Synapse Gradle Plugin**          | An optional plugin that deploys coprocessor code with robot code and starts simulation with Gradle | Your robot code project         |
| **Synapse Sim**                    | Simulated cameras that render a 3D field, so you can test without hardware                         | Your development computer       |

## Choose your path

{% tabs %}
{% tab title="I'm new to Synapse" %}

1. Read [How Synapse Works](https://danpeled.gitbook.io/synapse/getting-started/how-synapse-works.md).
2. Check [Common Hardware Setups](https://danpeled.gitbook.io/synapse/getting-started/quick-start/common-hardware-setups.md) and [Selecting Hardware](https://danpeled.gitbook.io/synapse/getting-started/hardware-selection/selecting-hardware.md).
3. Install the software and create your first project in [Quick Start](https://danpeled.gitbook.io/synapse/getting-started/quick-start.md).
4. Connect your robot code with [SynapseLib](https://danpeled.gitbook.io/synapse/robot-interfacing/synapse-bridge.md).
   {% endtab %}

{% tab title="I have a coprocessor" %}

1. Install the runtime in [Installing Software](https://danpeled.gitbook.io/synapse/getting-started/installing-software.md).
2. Create and deploy a project with [Project Management](https://danpeled.gitbook.io/synapse/usage/project-management.md). You can also deploy with the [Gradle Plugin](https://danpeled.gitbook.io/synapse/usage/project-management/gradle-plugin.md).
3. Open `http://<device-ip>:3000` and tune your pipeline in [UI Interaction](https://danpeled.gitbook.io/synapse/usage/built-in-pipelines-1.md).
   {% endtab %}

{% tab title="I want to write a pipeline" %}

1. Learn the pipeline lifecycle in [How Synapse Works](https://danpeled.gitbook.io/synapse/getting-started/how-synapse-works.md).
2. Follow [Custom Pipelines](https://danpeled.gitbook.io/synapse/usage/custom-pipelines.md).
3. Add tunable settings with the [Settings API](https://danpeled.gitbook.io/synapse/usage/custom-pipelines/settings-api.md).
4. Publish data with [Sending Results](https://danpeled.gitbook.io/synapse/usage/custom-pipelines/sending-results.md).
   {% endtab %}

{% tab title="I have no robot yet" %}

1. Try [Working without a robot](https://danpeled.gitbook.io/synapse/usage/working-without-a-robot.md).
2. Run the 3D field renderer with [Simulation](https://danpeled.gitbook.io/synapse/usage/simulation.md).
3. Test AprilTags and robot pose estimates before touching hardware.
   {% endtab %}
   {% endtabs %}

## Requirements at a glance

* A Linux coprocessor (Orange Pi 5, Raspberry Pi 5, or similar) with SSH enabled.
* Python 3.11–3.14 on the coprocessor. The installer can build Python 3.12 automatically if none is available.
* A development computer with Python 3.11–3.14.
* A camera supported by OpenCV/V4L2, or the built-in simulation cameras.
* Internet access on the coprocessor for the first install, so Python packages can be downloaded.

## Source Code

The source code for Synapse is available on [GitHub](https://github.com/DanPeled/Synapse).

## Contact Us

To report a bug or request a feature, [open an issue on GitHub](https://github.com/DanPeled/Synapse) or join the [Discord server](https://discord.gg/zHJRV8Stj3).
