Hanzo Dev
759177dfec
Complete rename of all environment variable references from MINIO_ prefix to S3_ prefix across the entire codebase: - internal/config/constants.go: EnvPrefix and all Env* constants - All Go source files: string literals, error messages, comments - Prometheus metrics: minio_* → s3_* metric name prefix - Dockerfiles: ENV declarations - Build scripts, CI workflows, helm charts, docs - Grafana dashboards: metric queries updated Go import paths and package names unchanged. Build verified: go build ./cmd/... passes clean.
Hanzo Storage
High-performance, S3-compatible object storage for AI workloads, built on MinIO and optimized for the Hanzo ecosystem.
Features
- S3 API Compatible -- Drop-in replacement for Amazon S3; works with any S3 client or SDK
- Built for AI & Analytics -- Optimized for large-scale model artifacts, training datasets, and data pipelines
- High Performance -- Designed to saturate modern NVMe and network hardware
- Erasure Coding -- Data protection with configurable redundancy across drives and nodes
- Bucket Policies -- Fine-grained access control with S3-compatible policy documents
- Object Lifecycle Management -- Automated expiration, transition, and tiering rules
- Encryption -- Server-side encryption (SSE-S3, SSE-KMS) for data at rest and in transit
- Multi-Tenancy -- Isolated namespaces and access boundaries for teams and services
Quick Start
Docker
Build and run a standalone Hanzo Storage server:
docker build -t hanzo-storage .
docker run -p 9000:9000 -p 9001:9001 \
hanzo-storage server /data --console-address :9001
The web console is available at http://127.0.0.1:9001. Default credentials are minioadmin:minioadmin -- change these immediately in production.
Install from Source
Requires Go 1.24 or later.
git clone https://github.com/hanzoai/storage.git
cd storage
go build -o hanzo-storage .
./hanzo-storage server /data --console-address :9001
Cross-compile for a specific target:
GOOS=linux GOARCH=arm64 go build -o hanzo-storage .
Verify Connectivity
Use any S3-compatible client. With the MinIO Client (mc):
mc alias set hanzo http://localhost:9000 minioadmin minioadmin
mc admin info hanzo
mc mb hanzo/my-bucket
mc cp ~/data/model.safetensors hanzo/my-bucket/
mc ls hanzo/my-bucket/
SDKs
Hanzo Storage is fully S3-compatible. Use any S3 SDK, or the purpose-built MinIO SDKs:
| Language | Package |
|---|---|
| Go | github.com/minio/minio-go/v7 |
| JavaScript / TypeScript | minio |
| Python | minio |
Standard AWS SDKs (aws-sdk-go, boto3, @aws-sdk/client-s3) also work without modification.
Documentation
Full documentation is available at docs.hanzo.ai.
Attribution
Based on MinIO. See the upstream LICENSE for attribution.
License
Copyright (c) Hanzo AI Inc. Licensed under the GNU Affero General Public License v3.0.