Download Magpie AI
Choose the best installation method for your machine: menu bar app, Homebrew cask, terminal TUI, or standalone binary.
One-Line Terminal Install
The official automated script detects your OS and architecture (macOS / Linux / Termux) to deploy the Magpie daemon and CLI
Works on macOS and major Linux distros. Auto-detects CPU architecture and installs the Magpie daemon.
Windows
Optimized for Windows 10/11 with full Windows Terminal integration. Runs cleanly as a background service.
macOS (Recommended)
Native support for Apple Silicon (M1-M4) and Intel. Runs silently in the menu bar with one-click model switching.
Linux / Termux
Lightweight static binaries for Ubuntu, Debian, Arch, and Docker. Includes the full interactive TUI mode.
GitHub Source & Releases
Visit yetone/magpie on GitHub for official release binaries, changelogs, and source code.
GitHubPractical Tutorials
Step-by-step guides on adding providers, setting up routing groups, and running Claude Code on DeepSeek.
TutorialsInstallation & Gateway Troubleshooting
Common solutions for initial installation, security prompts, port conflicts, and agent takeover.
What is the recommended installation method, and how to avoid timeouts?
We recommend the official automated curl script or Homebrew Cask. If you encounter network timeouts in restricted regions, simply append `--proxy` or choose a download mirror.
How to resolve macOS 'Unverified Developer' warnings?
Since this open-source build lacks commercial code signing, open System Settings -> Privacy & Security on first launch and click 'Open Anyway' to proceed normally.
Can I customize the local 3425 gateway port?
Yes. If port 3425 is already in use, update it in settings or start Magpie with `MAGPIE_PORT=port`. Magpie will automatically sync the Base URL for all managed tools.
How do I run Magpie on a headless Linux server?
Run `magpie tui` to launch the interactive terminal interface, or manage everything via CLI commands like `magpie provider add` without requiring any graphical desktop.
How do I unmanage an agent and restore native config?
Select the tool in Magpie menu bar and click 'Unmanage', or run `magpie reset [agent-name]` in your terminal to instantly restore the original native configuration.
Will updating Magpie lose my saved keys and configs?
Not at all. All provider credentials, routing rules, and account configurations are preserved in a dedicated home directory, completely unaffected by binary updates.