Remedy

Your personal AI partner — on your machine.
Knowledge · design · code · computer use · get-it-done.
One continuous partner — not a thin chat wrapper, not a farm of bots.

Download for Windows · Owner’s manual · What’s new · pip install remedy-ai

Not a medical product; the name means unsticking problems and finishing requests.
F1 opens the same Help wiki offline inside the app.

About

Remedy is a Windows-first desktop partner (Tauri + local FastAPI) that keeps continuity on disk under ~/.remedy while you pick the chat model (xAI, OpenAI, Anthropic, Google, DeepSeek, Groq, Mistral, OpenRouter, Ollama, Custom).

From the creator: My name is Ahmi, I hope you enjoy my Remedy.
In-app: title-bar / tray → About Remedy · Settings → About.

What’s new

Latest: v0.22.0 — Living organism, continuity steering, builder verify, multi-tab.

Also in 0.20–0.21: evidence ledger, shadow rehearsal, Action IR, Time Crystal, skill genome, portable identity, multi-tab stream paint, messengers, signed Skills Library.

Full owner notes → docs/manual/13-whats-new.md · engineering detail → CHANGELOG.md
Earlier: 0.19.0 parallel multi-provider · 0.18.x

Contents

1. About · What’s new
2. What you get — product at a glance
3. Why it’s different — local continuity + metabolism
4. Workspace on your PC — files, terminal, browser, computer
5. Local brain (SmolVLM2) — vision + efficiency without a second persona
6. Continuity workers — silent nano swarm
7. Messengers — chat where you already are
8. Skills & Library
9. Memory & long work
10. Install
11. Security
12. Slash commands
13. Architecture
14. CLI & API
15. Development
16. Support · License

Owner’s manual (GitHub + F1)

Also: CHANGELOG.md · AGENTS.md

What you get

One desktop app. One local API. Your data under ~/.remedy.

Your chat model is yours: xAI, OpenAI, Anthropic, Google, DeepSeek, Groq, Mistral, OpenRouter, Ollama, or Custom. Continuity and local SmolVLM2 live on disk, not in a Remedy cloud.

Why it’s different

You  →  Continuity (brief · memory · skills · budget · local SmolVLM2)  →  Your model  →  Tools
              ↑________________ learn / compress / remember ________________|

Deep dive: Continuity philosophy · In-app F1.

Workspace on your PC

Remedy is a workbench, not only a chat box. Icon rails open real tools next to the conversation:

Left · chat · right layout; popout / fullscreen for Terminal, Browser, Scratch.
Manual: Chat & sessions · Desktop notes

Local brain (SmolVLM2)

On-device efficiency — not a second chatbot.

How it ships: not in the installer → one first-run download → ~/.remedy/vision/ → llama-server on 127.0.0.1 → auto-starts with Remedy. CPU by default; CUDA when NVIDIA is available.

Manual: Local vision & on-device SmolVLM2

Continuity workers

Silent local workers (sometimes called the nano swarm in code). They measure, prune, rank, and distill. They do not take the microphone.

Heuristics first; local SmolVLM2 only when already running and useful.
Operators: Continuity workers · /harness

Messengers

Talk to Remedy where you already chat. Sessions show up in the desktop list (e.g. TG · …) with shared history.

Configure under Settings → Messengers. Empty allowlist = ignore inbound (unless you allow all).
Security defaults stay local-first: no public doorway by accident.

Skills & Library

Format: agentskills.io · Lifecycle: SKILL_LIFECYCLE.md · Manual: Skills

Memory & long work

• Durable memory — SQLite + FTS5, profile, handoffs
• Memory Harness — lean send-view for the model; full transcript kept
• Progress — mid-task snapshots (calm wording: progress, not “the app crashed”)
• Plans — Plan mode outlines; Build executes with approvals
• Time travel — restore chat (+ best-effort files) to an earlier step

/compact · /harness · Memory manual

Install

1. Download the latest Windows installer
2. Run Setup → provider + optional workspace + optional local vision
3. F1 Help · /help commands

SmartScreen? Solo builds are not Authenticode-signed yet — More info → Run anyway. Install only from this repo’s Releases. Updates are minisign-verified. Autostart = Startup folder (not registry Run).

Local API: 127.0.0.1:7400 (sidecar).

Security

Maximum capability for you. No accidental LAN doorway.

No Remedy cloud account for core use. Chat goes to your provider (or local Ollama).
Security & data

Slash commands

Full list: Commands

Architecture

┌─ Desktop (Tauri 2) ─────────────────────────────────────┐
│  React SPA · tray · updates · Files/Terminal/Browser   │
│              │                                           │
│  remedy serve · FastAPI :7400                            │
│    gateway · core · memory · skills · vision (SmolVLM2)  │
└──────────────────────────────────────────────────────────┘
     CLI · WebUI · Telegram · Discord · Slack · …

CLI & API

# Package name on PyPI is remedy-ai
pip install remedy-ai

remedy chat
remedy serve --host 127.0.0.1 --port 7400 --skip-setup
# Web UI http://127.0.0.1:7400/  ·  /docs  ·  /dashboard

WebUI is the same SPA as desktop (desktop/dist). After UI changes:
cd desktop && npm run build, then restart serve if needed — see AGENTS.md (Desktop SPA vs WebUI).

Development

git clone https://github.com/AhmiDarrow/RemedyAI.git && cd RemedyAI
uv sync --group dev
uv run pytest -q          # 560+ tests; currently ~1725
cd desktop && npm test && npm run build
python scripts/check_docs.py
cd desktop && npm run tauri:dev   # full shell (set REMEDY_DEV_ROOT to repo)

Release: python scripts/sync_version.py X.Y.Z · python scripts/sync_help_manual.py · python scripts/check_docs.py · tag vX.Y.Z · GitHub Actions.
Signing: AGENTS.md · WINDOWS_SIGNING.md

Support

patreon.com/cw/AhmiDarrow — thank you.

License

Source-available — LICENSE · COMMERCIAL.md

Copyright © 2025–2026 Ahmi Darrow.

My name is Ahmi, I hope you enjoy my Remedy.