Co-authored-by: Hanzo Dev <dev@hanzo.ai>
Hanzo Improvement Proposals (HIPs)
Hanzo Improvement Proposals (HIPs) are the primary mechanism for proposing new features, gathering community input, and documenting design decisions for the Hanzo AI ecosystem. This process ensures that changes to the Hanzo platform are transparently reviewed and achieve community consensus before implementation.
What is a HIP?
A Hanzo Improvement Proposal (HIP) is a design document that provides information to the Hanzo community about a proposed change to the system. HIPs serve as the formal pathway to introduce improvements and build agreement on their adoption. They are used for:
- Proposing new AI architectures, models, and infrastructure
- Defining standards for agent frameworks, protocols, and interfaces
- Collecting community input on platform design
- Documenting design decisions with pedagogical context (why we built what we built)
Quick Start
- New to HIPs? Begin with HIP-0000, the Hanzo AI Architecture overview
- Create a new HIP: copy
docs/templates/hip-template.mdtoHIPs/hip-<NNNN>-<slug>.md, then runpython3 scripts/lint-hips.py - View all HIPs: See the complete index below
HIP Index
| Number | Title | Type | Category | Status |
|---|---|---|---|---|
| HIP-0000 | Hanzo AI Architecture & Framework | Meta | - | Final |
| HIP-0001 | AI Token - Hanzo's Native Currency | Standards Track | Core | Review |
| HIP-0002 | Hamiltonian Large Language Models (HLLMs) Specification | Standards Track | Core | Draft |
| HIP-0003 | Jin Multimodal AI Architecture | Standards Track | Core | Draft |
| HIP-0004 | LLM Gateway - Unified AI Provider Interface | Standards Track | Interface | Draft |
| HIP-0005 | Post-Quantum Security for AI Infrastructure | Standards Track | Security | Final |
| HIP-0006 | Per-User Fine-Tuning Architecture for Personalized AI | Standards Track | Core | Draft |
| HIP-0007 | Active Inference Integration for Hamiltonian LLMs | Standards Track | Core | Draft |
| HIP-0008 | HMM (Hanzo Market Maker) - Native DEX for AI Compute... | Standards Track | Core | Draft |
| HIP-0009 | Agent SDK - Multi-Agent Orchestration Framework | Standards Track | Core | Draft |
| HIP-0010 | Model Context Protocol (MCP) Integration Standards | Standards Track | Interface | Final |
| HIP-0011 | Chat Interface Standard | Standards Track | Interface | Draft |
| HIP-0012 | Search Interface Standard | Standards Track | Interface | Draft |
| HIP-0013 | Workflow Execution Standard | Standards Track | Core | Draft |
| HIP-0014 | Application Deployment Standard | Standards Track | Infrastructure | Draft |
| HIP-0015 | Computer Control Standard | Standards Track | Interface | Draft |
| HIP-0017 | Analytics Event Standard | Standards Track | Interface | Draft |
| HIP-0018 | Payment Processing Standard | Standards Track | Interface | Draft |
| HIP-0019 | Tensor Operations Standard | Standards Track | Core | Draft |
| HIP-0020 | Blockchain Node Standard | Standards Track | Core | Draft |
| HIP-0024 | Hanzo Sovereign L1 Chain Architecture | Standards Track | Core | Draft |
| HIP-0025 | Bot Agent Wallet & RPC Billing Protocol | Standards Track | Core | Draft |
| HIP-0026 | Identity & Access Management Standard | Standards Track | Infrastructure | Active |
| HIP-0027 | Secrets Management Standard | Standards Track | Infrastructure | Final |
| HIP-0028 | Key-Value Store Standard | Standards Track | Infrastructure | Active |
| HIP-0029 | Relational Database Standard | Standards Track | Infrastructure | Active |
| HIP-0030 | Event Streaming Standard | Standards Track | Infrastructure | Draft |
| HIP-0033 | Container Registry Standard | Standards Track | Infrastructure | Final |
| HIP-0035 | Image & Video Generation Standard | Standards Track | Interface | Draft |
| HIP-0036 | CI/CD Build System Standard | Standards Track | Infrastructure | Draft |
| HIP-0039 | Zen Model Architecture | Standards Track | Core | Draft |
| HIP-0040 | Multi-Language SDK Standard | Standards Track | Interface | Draft |
| HIP-0041 | The Hanzo CLI — a Projection of the Served API | Standards Track | Interface | Draft |
| HIP-0042 | Vector Search Standard | Standards Track | Infrastructure | Active |
| HIP-0043 | Hanzo Engine — LLM Inference Engine Standard | Standards Track | Core | Active |
| HIP-0045 | Documentation Framework Standard | Standards Track | Interface | Draft |
| HIP-0046 | Embeddings Standard | Standards Track | Interface | Draft |
| HIP-0047 | Analytics Datastore Standard | Standards Track | Infrastructure | Active |
| HIP-0049 | DNS Service Standard | Standards Track | Infrastructure | Active |
| HIP-0050 | Hanzo Edge — Edge AI Runtime Standard | Standards Track | Infrastructure | Draft |
| HIP-0060 | Serverless Functions (FaaS) Standard | Standards Track | Infrastructure | Active |
| HIP-0061 | Notification & Messaging Service Standard | Standards Track | Interface | Draft |
| HIP-0063 | Feature Flags & Experimentation Standard | Standards Track | Interface | Draft |
| HIP-0064 | Log Aggregation & Search Standard | Standards Track | Infrastructure | Active |
| HIP-0065 | Backup & Disaster Recovery Standard | Standards Track | Infrastructure | Draft |
| HIP-0068 | Ingress Standard | Standards Track | Infrastructure | Active |
| HIP-0069 | Service Discovery & Auto-Bridge | Standards Track | Infrastructure | Final |
| HIP-0074 | Software Bill of Materials & Git Stamp Standard | Standards Track | Infrastructure | Draft |
| HIP-0077 | Mesh Identity, Gossip & Payments (PQ) | Standards Track | Infrastructure | Draft |
| HIP-0078 | Z-Chain — Post-Quantum Identity & Attestation Rollup | Standards Track | Infrastructure | Draft |
| HIP-0079 | Q-Chain — Quasar Finality Block Standard | Standards Track | Infrastructure | Draft |
| HIP-0084 | Pulsar-M — Threshold ML-DSA DKG & Signing | Standards Track | Cryptography | Draft |
| HIP-0085 | Wallet PQ Account Type (ML-DSA-65 native, 48-byte Ac... | Standards Track | Cryptography | Final |
| HIP-0086 | TxAuthEnvelope (typed PQ transaction signing) | Standards Track | Cryptography | Final |
| HIP-0087 | PQ Permit (replaces EIP-2612) | Standards Track | Cryptography | Final |
| HIP-0088 | Session KEM (ML-KEM-768/1024 for P2P) | Standards Track | Cryptography | Final |
| HIP-0089 | DRBG / Randomness Beacon (SP 800-90A/B) | Standards Track | Cryptography | Draft |
| HIP-0095 | QoS Challenge System | Standards Track | Core | Draft |
| HIP-0096 | AI Compute Contribution Rewards | Standards Track | Core | Draft |
| HIP-0097 | Node Identity and the did:hanzo: DID Method | Standards Track | Core | Draft |
| HIP-0098 | Governance / Upgrade Keys (ML-DSA-87 / SLH-DSA cold ... | Standards Track | Cryptography | Draft |
| HIP-0101 | Hanzo-Lux Bridge Protocol Integration | Standards Track | Bridge | Draft |
| HIP-0102 | Omnichain Bridge Integration | Standards Track | Bridge | Final |
| HIP-0103 | Bridge PQ-Only Profile | Standards Track | Infrastructure | Draft |
| HIP-0104 | Contract Auth via Z-Chain Proof | Standards Track | Infrastructure | Draft |
| HIP-0105 | In-Process Extension Runtime Standard | Standards Track | Infrastructure | Final |
| HIP-0106 | The Hanzo Plugin Contract | Standards Track | Infrastructure | Active |
| HIP-0107 | Streaming Replication over VFS | Standards Track | Infrastructure | Review |
| HIP-0108 | On-Demand Subsystem Supervisor + Warm Pool | Standards Track | Infrastructure | Draft |
| HIP-0109 | Hanzo ML Cloud Toolkit | Standards Track | Infrastructure | Draft |
| HIP-0111 | Hanzo IAM Authentication Standard | Standards Track | Infrastructure | Active |
| HIP-0113 | Cognitive Sidecar & Hanzo Engine Provider Runtime fo... | Standards Track | Core | Draft |
| HIP-0114 | ZAP — Inter-VM Cognitive Transport for Thinking Chains | Standards Track | Core | Review |
| HIP-0115 | Hanzo Frontend Delivery | Standards Track | Infrastructure | Active |
| HIP-0116 | Hanzo Plugin & VM Model | Standards Track | Infrastructure | Superseded |
| HIP-0117 | Cloud-in-a-Box — One Binary, Three Modes | Standards Track | Infrastructure | Review |
| HIP-0118 | SuperAdmin & Tenant Isolation Model | Standards Track | Security | Review |
| HIP-0119 | Hanzo Service Conventions | Standards Track | Infrastructure | Active |
| HIP-0120 | ZAP-Native Transport & gRPC Elimination | Standards Track | Core | Review |
| HIP-0121 | BYO Compute Fleet & Metered Billing | Standards Track | Core | Review |
| HIP-0122 | zip — The ZAP-Native Application Server Core | Standards Track | Infrastructure | Final |
| HIP-0123 | Visor — Fleet & Fabric Autoscaling Across Any Provider | Standards Track | Infrastructure | Review |
| HIP-0124 | Bring-Your-Own Provider & AI — Unified Dashboard and... | Standards Track | Platform | Final |
| HIP-0125 | Consensus-Backed Plugin-Placement Platform | Standards Track | Infrastructure | Draft |
| HIP-0126 | Integrations, Connectors & the Extension Runtime — O... | Standards Track | Interface | Review |
| HIP-0127 | V8 · Open Edition — Architecture, Distribution & the... | Standards Track | Meta | Active |
| HIP-0128 | Resource Surface Standard — Generated REST over ZAP | Standards Track | Core | Draft |
| HIP-0129 | Eval — The Judgment Plane | Standards Track | Infrastructure | Draft |
| HIP-0130 | Open-Core Split — the Tenancy Line, the Composition ... | Standards Track | Core | Draft |
| HIP-0132 | One Telemetry Plane — One Door, One Schema, Many Lenses | Standards Track | Infrastructure | Active |
| HIP-0133 | Entity Groups — Placement, Durability, Splitting and... | Standards Track | Core | Draft |
| HIP-0134 | One Process, One Socket, One Identity | Standards Track | Core | Final |
| HIP-0135 | What Is Public | Process | Governance | Final |
| HIP-0136 | One Secret, One Path | Standards Track | Infrastructure | Active |
| HIP-0137 | One License | Process | Governance | Active |
| HIP-0200 | Responsible AI Principles and Commitments | Meta | - | Draft |
| HIP-0201 | Model Risk Management | Meta | - | Draft |
| HIP-0210 | Safety Evaluation Framework | Meta | - | Draft |
| HIP-0220 | Bias Detection & Mitigation | Meta | - | Draft |
| HIP-0230 | AI Transparency & Explainability | Meta | - | Draft |
| HIP-0240 | AI Incident Response | Meta | - | Draft |
| HIP-0250 | Sustainability Standards Alignment Matrix | Meta | - | Draft |
| HIP-0251 | AI Compute Carbon Footprint | Meta | - | Draft |
| HIP-0260 | Efficient Model Practices | Meta | - | Draft |
| HIP-0270 | AI Supply Chain Responsibility | Meta | - | Draft |
| HIP-0301 | Agent Runtime Protocols & Cross-Platform Parity | Standards Track | Core | Draft |
| HIP-0302 | Hanzo Replicate: Encrypted SQLite Durability for Bas... | Standards Track | Infrastructure | Final |
| HIP-0303 | Hanzo adopts LP-0010: Brand Sovereignty and Federati... | Meta | Governance | Final |
| HIP-0305 | esign: shared-DB tenancy via team-where, not file-pe... | Standards Track | Infrastructure | Final |
| HIP-0306 | AML Transaction Monitoring, Screening and Case Manag... | Standards Track | Infrastructure | Draft |
| HIP-0400 | Service CRD | Standards Track | Operator | Final |
| HIP-0401 | Datastore CRD | Standards Track | Operator | Final |
| HIP-0402 | SQL CRD | Standards Track | Operator | Final |
| HIP-0403 | KV CRD | Standards Track | Operator | Final |
| HIP-0404 | DocDB CRD | Standards Track | Operator | Final |
| HIP-0405 | S3 CRD | Standards Track | Operator | Final |
| HIP-0406 | DNS CRD | Standards Track | Operator | Final |
| HIP-0407 | Base CRD | Standards Track | Operator | Final |
| HIP-0408 | IAM CRD | Standards Track | Operator | Final |
| HIP-0409 | KMS CRD | Standards Track | Operator | Final |
| HIP-0410 | LLM CRD | Standards Track | Operator | Final |
| HIP-0411 | Ingress CRD | Standards Track | Operator | Final |
| HIP-0412 | Gateway CRD | Standards Track | Operator | Final |
| HIP-0413 | MPC CRD | Standards Track | Operator | Final |
| HIP-0414 | Network CRD | Standards Track | Operator | Final |
| HIP-0418 | Indexer CRD | Standards Track | Operator | Final |
| HIP-0419 | Explorer CRD | Standards Track | Operator | Final |
| HIP-0504 | Unified Cross-Platform Design System | Standards Track | Interface | Draft |
| HIP-0506 | Hanzo Studio — Agentic Multi-Modal Creative Runtime | Standards Track | Application | Draft |
| HIP-0512 | Experiment — The Evidence Plane | Standards Track | Infrastructure | Active |
| HIP-0516 | Translate — One Endpoint, Two Tiers, Permissive Weights | Standards Track | Core | Final |
| HIP-0517 | Branch Naming — main is the Trunk, Everywhere | Process | Meta | Active |
| HIP-0518 | AML — The Obligation Plane | Standards Track | Interface | Draft |
| HIP-0519 | One Identity Boundary | Standards Track | Infrastructure | Active |
| HIP-0520 | Serving Topology — Three Tiers, Horizontally Scalabl... | Standards Track | Infrastructure | Active |
| HIP-0521 | Org Hierarchy | Standards Track | Security | Draft |
| HIP-0901 | Proof of AI (PoAI) — Native Execution Proofs, Canoni... | Standards Track | Core | Final |
| HIP-0902 | Proof of Code — Consensus over Git Refs | Standards Track | Core | Draft |
| HIP-0903 | The Agentic Company — Autonomous Firms on Hanzo | Informational | Meta | Draft |
HIP Process
- Have an idea - Discuss with the community
- Draft your HIP - Copy
docs/templates/hip-template.md - Submit a Pull Request - To the hanzoai/hips repository
- Get reviewed - HIP editors review for completeness
- Build consensus - Community discussion and feedback
- Last Call - Final 14-day review period
- Final - Accepted as standard
Types of HIPs
scripts/lint-hips.py holds the machine copy of these three vocabularies and
fails the build on any value outside them. This section and that file must agree.
- Standards Track: describes one thing we build and maintain. Exactly one public repository, and exactly one HIP for it. Requires a category.
- Process: how we work — numbering, branch names, what is public. Not 1:1 with a repository, and not expected to be.
- Meta: governance, principles, and commitments.
- Informational: guidance that normatively requires nothing.
Categories
Standards Track HIPs carry exactly one:
Core · Interface · Infrastructure · Security · Cryptography ·
Operator · Bridge · Governance · Meta · Application · Platform
Status
| Status | Meaning |
|---|---|
Draft |
Written, not yet reviewed |
Review |
Under review by HIP editors |
Last Call |
Final 14-day review window |
Final |
Accepted as standard; changing it needs a new HIP |
Active |
Accepted and continuously updated (living standards) |
Superseded |
Replaced; MUST name its successor in superseded-by |
Withdrawn |
Abandoned by its author |
There is one spelling per state. Proposed, Implemented and Accepted were
each a second name for one of the above and have been folded into it.
Resources
- Documentation: docs.hanzo.ai
- Discord: discord.gg/CJCyAsm9Vr
- GitHub: github.com/hanzoai
- Twitter: @hanzoai
License
All HIPs are released under CC0 1.0 Universal Public Domain Dedication.