mirror of https://github.com/hanzoai/s3.git synced 2026-11-03 03:07:41 +00:00

Files

T

zeekay e24f1e2c89 rebrand: complete MinIO → Hanzo S3 rename across entire codebase

- Change s3ReservedBucket constant from "minio" to "s3" so health
  endpoints register at /s3/health/* instead of /minio/health/*
- Update Prometheus metrics namespace from "minio" to "s3"
- Update API response DisplayName from "minio" to "s3"
- Update release binary name and download URL references
- Multi-stage Dockerfile.hanzo with distroless base for CI builds
- Update publish workflow with build-args for version injection
- Update .gitignore for new binary naming convention
- 780+ files touched by automated rebrand script

2026-03-13 20:03:20 -07:00

2.8 KiB

Raw Permalink Blame History

Hanzo S3

High-performance, S3-compatible object storage for AI workloads, 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

docker run -p 9000:9000 -p 9001:9001 \
  -e S3_ROOT_USER=admin \
  -e S3_ROOT_PASSWORD=changeme123 \
  ghcr.io/hanzoai/s3:latest server /data --console-address :9001

Console: http://127.0.0.1:9001 -- change the default credentials immediately in production.

Install from Source

Requires Go 1.24 or later.

git clone https://github.com/hanzoai/s3.git
cd s3
go build -o hanzo-s3 .
./hanzo-s3 server /data --console-address :9001

Verify Connectivity

Use any S3-compatible client. With the Hanzo S3 CLI (s3):

s3 alias set hanzo http://localhost:9000 admin changeme123
s3 admin info hanzo
s3 mb hanzo/my-bucket
s3 cp ~/data/model.safetensors hanzo/my-bucket/
s3 ls hanzo/my-bucket/

SDKs

Hanzo S3 is fully S3-compatible. Use any S3 SDK:

Language	Package
Go	`@hanzo/s3-go`
JavaScript / TypeScript	`@hanzo/s3`
Python	`hanzo-s3`

Standard AWS SDKs (aws-sdk-go, boto3, @aws-sdk/client-s3) also work without modification.

Documentation

Full documentation at docs.hanzo.ai/storage.

Demo Server

A public demo server is available at s3-demo.hanzo.ai for testing. Data is wiped hourly.

Attribution

Based on MinIO. See the upstream LICENSE for attribution.

2.8 KiB Raw Permalink Blame History