ProjectsApps
Apps, Python
Remedy
A full AI partner on this PC: one continuous being who remembers you, holds your goals, speaks and hears, builds real software end-to-end, and works the desktop and web as your hands. Models swap as muscle; she stays.
v0.70.2 released
A partner for any ability level — she drives this computer to finish the goal you set.
Download for Windows
·
Download for macOS
·
Install on Linux
·
Owner’s manual
·
What’s new
·
pip install remedy-ai
Not a medical product. F1 (or Ctrl+/) opens the same Help wiki inside the app.
Remedy lives on this computer. The Desktop app runs on Windows x64, Linux (including WSLg), and macOS (Apple Silicon and Intel). The CLI also runs on Windows ARM64 and Linux ARM64. Grove is home. Studio is the workbench. Continuity is ~/.remedy. You bring the model (cloud keys or RMB locally). Money, passwords, submit, send, and delete stop for you.
| Latest release | |
Source on master |
|
| Owner’s manual | docs/manual/ · index |
| Install | Windows · Linux · macOS Desktop from Releases · CLI via pip install remedy-ai |
| Security / data | 04-security-and-data |
| Commands / keys | 11-reference-commands · 12-reference-shortcuts |
| Changelog | CHANGELOG.md |
Local API: 127.0.0.1:7400. Close ✕ hides to the tray on Windows, the menu bar on macOS, and minimizes on Linux/WSLg. pip install remedy-ai then remedy serve downloads a checksum-verified remedy-runtime and remedy_core for this OS from GitHub Releases on first run (cached in ~/.remedy/runtime/).
Reasoning effort, thinking budget, max output tokens, and context window can be set for all models or per model (Settings → Reasoning and context, remedy settings set reasoning_effort=high, or config.toml). Unset keeps each provider's default. See Reasoning effort and context.
From the creator: My name is Ahmi, I hope you enjoy my Remedy.
Supported platforms
These are the platforms with published assets on the latest GitHub release. The table lists only triples that shipped and whose checksums were verified against remedy-native-SHA256SUMS.txt. From 0.69.0 the main release lists only the Desktop installers and latest.json. The CLI runtime files, macOS updater tarballs, and signatures are on a runtime-v<version> companion prerelease, which pip installs fetch automatically.
| Platform | Desktop app | CLI (pip install remedy-ai) |
|---|---|---|
| Windows x64 | Yes — Remedy.Desktop_*_x64-setup.exe |
Yes |
| Windows ARM64 | — | Yes |
| Linux x86_64 | Yes — AppImage and .deb |
Yes |
| Linux arm64 | — | Yes |
| macOS arm64 (Apple Silicon) | Yes — unsigned Remedy.Desktop_*_aarch64.dmg |
Yes |
| macOS x86_64 (Intel) | Yes — unsigned Remedy.Desktop_*_x64.dmg |
Yes |
There is no Windows ARM64 Desktop installer in this release. macOS builds are ad-hoc signed and not notarized.
Install
Windows x64 (Desktop). Download Remedy.Desktop_*_x64-setup.exe, run the installer, and launch from the Start Menu or the desktop shortcut. Details: Install on Windows.
Linux x86_64 (Desktop). From the same Releases page:
.deb(Debian/Ubuntu):sudo apt install ./Remedy.Desktop_*_amd64.deb- AppImage:
chmod +x Remedy.Desktop_*.AppImage && ./Remedy.Desktop_*.AppImage
Details: Install on Linux.
macOS (Desktop, Apple Silicon and Intel). From the same Releases page, download Remedy.Desktop_*_aarch64.dmg (Apple Silicon) or Remedy.Desktop_*_x64.dmg (Intel). Open the disk image and drag Remedy Desktop to Applications. This build is unsigned (ad-hoc codesign, no Apple notarization). First launch: right-click the app and choose Open, or clear quarantine:
xattr -dr com.apple.quarantine "/Applications/Remedy Desktop.app"In-app updates use the minisign-signed .app.tar.gz from the same release.
CLI on Windows (x64 and ARM64), Linux (x86_64 and arm64), and macOS (arm64 and x86_64):
pip install remedy-ai remedy serve
Then open http://127.0.0.1:7400. First run downloads the checksum-verified remedy-runtime / remedy_core pair for this OS and caches them under ~/.remedy/runtime/ (or %USERPROFILE%\.remedy\runtime\ on Windows). No Go or Zig toolchain is required. HQ voice reference clips download into ~/.remedy/voice/references/ on first use.
Development
git clone https://github.com/AhmiDarrow/RemedyAI.git && cd RemedyAI uv sync --group dev uv run ruff check . uv run mypy uv run pytest -q cd desktop && npm test && npm run build cd ../desktop/src-tauri && cargo test --locked cd ../../native/go && go test -race ./... && go vet ./... cd ../zig && zig build test -Doptimize=ReleaseSafe cd ../../android && ./gradlew testDebugUnitTest lintDebug assembleDebug assembleRelease cd .. && uv run python scripts/check_docs.py && uv build
Before a push, the same matrix runs locally as the pre-push gate: uv run python scripts/prepush.py
(enable once per clone with git config core.hooksPath .githooks). Windows uses gradlew.bat;
Go race detection also runs on Linux CI. CI exercises Python
3.12/3.13, a Windows-sensitive pytest surface, the React SPA, both Tauri targets,
RemedyConnect Android, the Go/Zig native runtime, and Python packaging.
Version / help / docs / sanitize gates: scripts/sync_version.py · scripts/sync_help_manual.py · scripts/check_docs.py · scripts/check_sanitize.py.
Contributing: CONTRIBUTING.md · signing: WINDOWS_SIGNING.md
Support
License
Apache License 2.0 — LICENSE · NOTICE
Free to use, modify, and redistribute, including commercially. Use is at your own risk; see TERMS. Third-party notices: desktop/public/THIRD_PARTY_NOTICES.txt.
Copyright © 2025–2026 Ahmi Darrow.
"Hope this helps" - Ahmi
This comes from the project's README. Read it on GitHub
