Magpie

Content-addressed artifact storage with mutable tags for distributing build artifacts, container images, and deployment packages.

Why Magpie

Magpie is a lightweight, open source, content-addressed versioned artifact store. If you don't need the overhead of Artifactory or a container registry and just need to store and tag arbitrary files, that's what it's for.

• SHA-256 content addressing with automatic deduplication
• Mutable tags (latest, stable) pointing to immutable artifacts
• Optional provenance tracking via source URI metadata
• Bearer token auth with optional Authentik SSO
• Garbage collection with configurable retention

Documentation

• Quick Start
• Installation Guide
• User Guide
• Documentation Index

Development

uv sync                                          # Install dependencies
uv run uvicorn magpie.server.app:app --reload   # Run server locally
docker compose up --build                        # Full stack with Caddy
uv run pytest tests/unit/ -v                     # Run tests
uv run ruff check src/ tests/                    # Lint

See CONTRIBUTING.md for full development workflow.

Installation

# Server (via container)
docker pull ghcr.io/southwestccdc/magpie:latest

# Client (via pip)
uv pip install git+https://github.com/SouthwestCCDC/magpie

Pin to full tags (1.0.1) for production; latest tracks newest releases.

See Installation Guide for deployment details and Release Notes for version history.

---

Documentation improved with AI assistance (Claude Code w/ Sonnet 4.5).