Apache Magpie™ Documentation

Apache Magpie is an AI assistant for open-source project maintainers. It handles the repetitive parts of running a project — triaging issues, reviewing PRs, onboarding contributors, managing security reports, cutting releases — so maintainers can spend their time on the work that needs a human. The agent proposes; the human decides.

⚡ Quick Start

Install Apache Magpie into the agent you already use — one command to add the Apache Magpie Marketplace, one per family you want. That install is yours, on this machine: nothing is committed to your repository, and it needs no decision from your project and no opt-in from your teammates.

Adoption is the other thing, and it belongs to the project. It is not an install but a maintainer decision — the team agreeing which families they recommend here and how those should behave in this project, then committing that floor so everyone who clones the repo picks it up on arrival. It affects every contributor, so it is the project's call to make together — and you do not have to choose before installing.

Not sure what Magpie is yet? What is Apache Magpie? · Architecture

Explore the docs

154 pages, synced from apache/magpie/docs and grouped by area. Every page is also in the sidebar.

Concepts

What Magpie is and the ideas it is built on — the design principles, the agentic modes and what they cost, labels and capabilities, vendor neutrality, and confidentiality.

Updating Magpie

Working on the framework itself — the spec-driven build loop, the editorial playbook for text it produces, how contributor sentiment is measured, the pilot report template, what ships in a source release, and how to extend Magpie without forking it.

Education

The maintainer-education stream — a step-by-step path to building and running agents for your project: what agents are, working with them, writing and evaluating your first skill, English as code, and contributing back, plus a pattern catalogue and hands-on tutorials.

Training

An LMS-neutral Apache Training module that wraps the education stream as a structured course — one lesson per progression page, each adding learning objectives, exercises, and self-check questions.

Setup

Wire Magpie into a repo and run agents safely — the marketplace, individual use versus team adoption, sandboxing, per-role MCP access, privacy/LLM routing, and uninstalling.