magpie

Overview

magpie is a powerful, open-source tool that acts as a universal gateway, connecting all your AI agents with every available model. It simplifies the process of integrating diverse AI providers, including DeepSeek, Kimi, GLM, Qwen, OpenRouter, and Ollama, as well as existing paid plans for Claude and ChatGPT. magpie runs a local gateway that translates requests between agents and models, supporting streaming, tool calls, and reasoning.

Key Features

• Universal Model Access: Connects to numerous AI providers and local models (Ollama, etc.) through a single interface.
• Agent Integration: Works with a wide array of agents like Codex, Claude Code, Gemini CLI, and more.
• Privacy Masking: Protects sensitive information by replacing secrets with placeholders before sending requests to vendors, ensuring they are never exposed.
• Subscription Sharing: Allows paid plans (Claude, ChatGPT, Copilot) to be utilized across multiple agents without re-pasting keys.
• Smart Routing: Intelligently routes requests to the most suitable model based on intent, availability, and cost, with failover mechanisms.
• Local Gateway: Runs a gateway on your machine (127.0.0.1:3425) that handles all communication.
• Configuration Management: Offers surgical config edits, with support for various file formats (settings.json, config.toml, config.yaml).
• Native & Open Source: A small, native application (15MB download) with an MIT license, available on GitHub.
• Terminal & TUI: Provides both a graphical interface and a terminal-based UI/CLI for interaction.

Use Cases

• Developers: Seamlessly integrate various AI models into their coding workflows and agents.
• AI Enthusiasts: Experiment with different AI models and providers without complex setup.
• Teams: Standardize AI model usage across different agents and projects.
• Privacy-Conscious Users: Leverage AI models while ensuring sensitive data remains protected.

FAQ

Q: How does magpie ensure privacy?

• A: magpie masks sensitive information (API keys, tokens, etc.) with placeholders before sending requests to vendors. These placeholders are restored in the response, so your secrets never reach the vendor.*

Q: Can I use my existing paid subscriptions with magpie?

• A: Yes, magpie allows you to use your paid plans for services like Claude, ChatGPT, and Copilot across different agents without needing to re-enter keys.*

Q: What happens if a model or provider becomes unavailable?

• A: magpie features smart routing and failover mechanisms. If a model or provider is rate-limited, out of credit, or fails, magpie automatically routes the request to another available option.*

Q: Is magpie difficult to set up?

• A: No, setup is designed to be simple. For many providers, you only need to paste an API key. The application is also available as a small download for macOS, Windows, and Linux.*

Q: Does magpie support local AI models?

• A: Yes, magpie supports local model servers like Ollama, allowing you to use models running on your own machine.*

Q: How are updates handled?

• A: magpie updates itself quietly in the background and installs the new version upon restart.*