> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

The Miru Agent is a lightweight [systemd](https://en.wikipedia.org/wiki/Systemd) service that runs on your machines, handling the deployment lifecycle of configurations. The agent offers the following functionality:

* **Syncs configurations** from the cloud to the local file system in real-time
* **Manages device state**, providing real-time updates of the device's status and the currently deployed configurations
* **Uploads data** off the device to your own cloud storage, per your [upload rules](/data-uploads/primitives/upload-rules)
* **Exposes a local REST API** with event streaming over a Unix socket for programmatic access by applications running on the same machine

## Key benefits

The Miru Agent offers the following key benefits:

* **Offline resilience** - configurations are cached locally on the machine and synced as soon as the network is available, ensuring continued operation through network interruptions
* **Secure communication** - all communication is outbound-only via HTTPS or MQTT over TLS, ensuring secure and private communication
* **Lightweight footprint** - our rust-based agent consumes minimal resources and may be configured to only run on demand (via socket activation) for further optimization
* **Open-source** - the agent is open-source and available on [GitHub](https://github.com/mirurobotics/agent)

## REST API

Applications running on the same machine as the Miru Agent can access it via the agent's [Device API](/developers/device-api/overview). Use it to fetch the currently deployed configurations, trigger a manual sync, check the agent's status, or read device metadata—without round-tripping to the cloud.

In addition to request/response endpoints, the Miru Agent exposes a [Server-Sent Events (SSE) stream](/developers/device-api/events) that pushes notifications to your application in real time.

<Card title="Device API" icon="bot" href="/developers/device-api/overview">
  Learn more about the Device API for programmatic access to the Miru Agent.
</Card>

## Supported platforms

The Miru Agent only supports Linux. MacOS and Windows are not supported.

The following operating systems are tested and verified to work with the Miru Agent:

* Ubuntu 20.04, 22.04, and 24.04 LTS
* NVIDIA Jetson JetPack 5.1 and JetPack 6.1
* Raspberry Pi OS (64-bit)

Other Linux distributions and versions may also work, but have not been explicitly tested.