About this project

Artifact Gateway is an early-release (v0.1.0) lightweight artifact repository system written in Go. It provides a protocol-native interface for hosting and proxying software artifacts across multiple package ecosystems. **Supported Formats:** - OCI (Registry V2 uploads, manifests, tags, referrers) - Maven (Gradle-compatible, Nexus-style root optional) - npm (native publication, merged packuments) - PyPI (Nexus-root twine upload, PEP 503/691 reads) - Go modules (GOPROXY reads, Nexus-compatible ZIP publication) - Conan 2 (revision-aware lifecycle) - Raw artifacts (PUT/GET/HEAD, ranges, resumable upload) - APT (preview only) **Architecture:** PostgreSQL serves as the sole coordination and database dependency, handling repository state, authorization, lifecycle jobs, leases, locks, idempotency, and audit. S3-compatible object storage (RustFS bundled locally) holds artifact bytes outside the database. No Redis, Kafka, Elasticsearch, or external message queues are required. The default standalone role runs API, scheduler, and worker responsibilities in one process; larger deployments can split by role. **Operational Details:** - Binary size: approximately 28.88 MiB (Linux/arm64) - Idle memory: ~53.59 MiB; peak ~104 MiB under 128 concurrent clients - Web Console available at port 4173 for repository management - Supports OIDC SSO, service accounts, anonymous-read policy, retention, promotion, replication, webhooks, scanning integration, quarantine, metrics, and backup/restore workflows **Deployment:** Container images are published to GHCR. A Docker Compose quickstart is available via `make dev-bootstrap` and `make dev`. Kubernetes and distributed deployment documentation is provided. PostgreSQL migrations are bundled. **License:** MIT Project status is early release; pre-1.0 contracts may evolve.