grafhub Documentation
grafhub is the human-facing forge for the graf package ecosystem. It serves three communities:
Janus Developers
Publish and install .jpk packages via Hinge.
graf-forge indexes your manifest; Hinge resolves your lockfile.
hinge add owner/package
Nexus Operators
System packages (.npk) for Nexus OS. Six subtypes from firmware
to applications, managed by Nip.
nip install owner/package
AI Agents
Every package has machine-readable endpoints returning Canonical JSON, Markdown overviews, and file trees. No scraping needed.
GET /{owner}/{name}/agent/manifest
Architecture
| Domain | Purpose | Audience |
|---|---|---|
| grafhub.org | Human-facing forge (this site) | Developers, browsers |
| graf-forge.org | Machine-facing registry API | CLI tools, agents, CI/CD |
| graf.tools | Marketing & brand site | Everyone |
Key Principles
- Anonymous by default. No email, no KYC. Just an Ed25519 Soul Key.
- The index is free. Publishing manifests costs nothing. Forever.
- Storage is a market. Binary artifacts live on R2 with metered tiers.
- BLAKE3 everywhere. Content-addressed integrity from manifest to lockfile.
- Transparent compression. CAS objects are deflate-compressed on disk – CIDs stay content-addressed on raw bytes. Compression is a storage optimization, invisible to the addressing layer. Future-slotted for zstd when Zig's compressor matures.
- Traffic lights, not stars. Packages get red/orange/yellow/green trust signals computed from license, attestations, and community signals.