# Pelorus

Pelorus is an AI navigator for Selkies-powered Linux desktops that gives a large language model (LLM) agent control over the mouse, keyboard, screenshots, and window management. It is open source and self-hosted, installable on Docker Hub, Unraid and ZimaOS.

Canonical page: https://ourlocalhost.com/app/2288/pelorus

## Description

Pelorus is an AI navigator for Selkies-powered Linux desktops that gives a large language model (LLM) agent control over the mouse, keyboard, screenshots, and window management. It runs a FastAPI server that connects the LLM (Ollama, OpenAI-compatible, or Gemini) to the desktop through the Pixelflux computer-use backend, the Linux accessibility tree (AT-SPI), and optional KWin D-Bus integration, so you can hand desktop tasks to an AI agent.

## Platform availability

Available on 2 of 10 platforms: Unraid, ZimaOS.

## Health score

61/100 (Good), based on 3 of 4 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/linuxserver/pelorus
- GitHub: https://github.com/linuxserver/docker-pelorus
- Unraid: https://ca.unraid.net/apps/pelorus-1xq81hs0e75xo4?q=pelorus
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/pelorus

## Common questions

### Which port does Pelorus listen on by default?

It listens on 0.0.0.0:5100 unless the PELORUS_PORT environment variable is set.

### Where does Pelorus keep its server configuration?

It creates /config/agent/config.toml on first run, seeded from environment variables. The model servers are defined in that file.

---
Source: Our Local Host (https://ourlocalhost.com/app/2288/pelorus), the self-hosted and open-source app directory.
