Roamies

Roamies is a little AI buddy that lives on your desktop. It stays by your cursor, talks back in its own voice, keeps track of what you said you'd do and nudges you when it's due.

[!TIP] Want to build your own apps with AI? A free 7-day build challenge and 20+ step-by-step projects are in my free community: skool.com/raid

⭐ If Roamies keeps you on track, give it a star. It's the main way other people find it.

Why Roamies

• Talk, don't type. Hold ⌃⌥ (Ctrl+Alt on Windows and Linux), say it, let go. On macOS and Windows, circle something with the cursor while you talk and it sees what you mean.
• It talks back. Spoken replies in its own voice, with real feeling, through Fish Audio.
• It remembers. What you said you'd do, reminders down to the second, and what matters to you.
• It draws on your screen. Rings the exact button to click, walks you through each step, and sketches answers beside what you're reading.
• It does the clicking. Opens apps, sites and files, and on macOS and Windows clicks or types in other apps for you.
• Your subscriptions. Sign in with Claude or ChatGPT, or use an API key (Gemini, Grok, Kimi Code and more).

Each one has its own name, voice and animations, in three sizes: Default, Small, or Cursor, a pixel pointer that rides along with your mouse.

JARVIS shows you how

Ask how to do something in any app. JARVIS turns into its cursor, rings the exact button on your real screen, says the step out loud and waits for your click before showing the next one.

JARVIS explains anything

Ask about whatever you're looking at. JARVIS sketches the answer right beside it while it talks: cards, graphs, timelines, photos, molecules and turning 3D models, all in its own glowing ink. Ask it to change any part, or clear it all in one go.

Also included

• The Roamies panel: click the menu bar or tray icon (on Linux, Open Panel in its menu) for what it's doing, what it remembers, and every setting.
• Safe by default: file edits, commands and app control stay off until you turn them on, and risky steps always ask.
• Shows its work: every tool plays its own animation, so you can see what it's doing.
• Where keys live: your Fish Audio key stays in the macOS Keychain (encrypted with Windows DPAPI on Windows, in your desktop's keyring on Linux). AI sign-ins are stored in ~/.gg/auth.json, shared with GG Coder.
• Out of the way: no Dock or taskbar button, a shortcut shows or hides it (see the table), Esc stops a reply.
• Updates itself: updates are signature-checked before they install, then it restarts itself. The Windows installer isn't code-signed yet, so SmartScreen warns the first time. On Linux only the AppImage updates itself.
• Quick setup: permissions, sign-in and a short chat so it gets to know you.

* On Wayland (the default on Ubuntu, Fedora and KDE), apps can't grab keys, so you bind Roamies' commands to keys in your desktop's keyboard settings. Linux (beta) shows how.

Before macOS 26, talking uses Apple's older speech recognizer, which needs Siri or Dictation turned on.

On Windows, Roamies reads other apps through UI Automation and finds words on screen with Windows' own text recognition (it needs a Windows language with text recognition, which most have). It can't type or click in apps running as administrator, and it borrows your cursor for real clicks, keys and scrolling, giving it back when it's done. Windows also leaves Roamies out of every screen capture, so it won't show in your screenshots or screen shares.

Spoken replies are billed to your own Fish Audio account; the panel shows what each voice model costs. Voice on Windows and Linux uses NVIDIA Parakeet TDT 0.6B v3 (CC BY 4.0), in the ONNX export by istupakov, run with parakeet-rs. The model (about 670 MB) downloads once at setup and isn't bundled.

Get started

1. Install Roamies:

   macOS (Apple silicon or Intel): Download the latest release and open the .dmg for your Mac (aarch64 for Apple silicon, x64 for Intel). Requires macOS 13.5 or later.

   Windows: Download the latest release and run the .exe installer. Requires Windows 10 or later. It isn't code-signed yet, so Windows shows a SmartScreen warning the first time: click More info, then Run anyway.

   Linux (beta, x86_64): Download the latest release and pick one: the .deb (Ubuntu, Debian, Mint, Pop!_OS: sudo apt install ./Roamies_*_amd64.deb), the .rpm (Fedora, openSUSE: sudo dnf install ./Roamies-*.x86_64.rpm), or the .AppImage (any distro: chmod +x it and run it; only the AppImage updates itself). Needs glibc 2.38 or later: Ubuntu 24.04, Fedora 39, Debian 13 or newer. See Linux (beta) for what works and how to set up shortcuts.

   Development: With Rust, Node.js 22+, the Tauri prerequisites and, on macOS, the Xcode Command Line Tools installed:

   git clone https://github.com/KenKaiii/Roamies.git
   cd Roamies/showcase/tauri
   (cd sidecar && npm ci && npm test)
   ./build.sh dev        # debug build
   ./build.sh