✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Hippius

Hippius decentralized storage on Bittensor Subnet 75 — upload files, query storage, manage buckets.

Rating: 4.7 (265 reviews)
Downloads: 2,852 downloads
Version: 1.0.0

Overview

Hippius decentralized storage on Bittensor Subnet 75 — upload files, query storage, manage buckets.

Complete Documentation

View Source →

Hippius Storage

Hippius is decentralized cloud storage on Bittensor SN75 with S3-compatible API.

Recommended path: S3 endpoint (s3.hippius.com) — the public IPFS node is deprecated.

Quick Reference

Key	Value
S3 Endpoint	https://s3.hippius.com
S3 Region	decentralized
Access Key Format	hip_xxxxxxxxxxxx
Console	console.hippius.com
Python CLI	pip install hippius (requires self-hosted IPFS node)

Setup

Get S3 credentials from console.hippius.com → Settings → API Keys
Set environment variables:

bash

export HIPPIUS_S3_ACCESS_KEY="hip_your_access_key"
   export HIPPIUS_S3_SECRET_KEY="your_secret_key"

Test: aws --endpoint-url https://s3.hippius.com --region decentralized s3 ls

Common Operations

Upload

bash

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 cp <file> s3://<bucket>/<key>

Download

bash

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 cp s3://<bucket>/<key> <local_path>

List buckets

bash

aws --endpoint-url https://s3.hippius.com --region decentralized s3 ls

List objects

bash

aws --endpoint-url https://s3.hippius.com --region decentralized s3 ls s3://<bucket>/ --recursive

Create bucket

bash

aws --endpoint-url https://s3.hippius.com --region decentralized s3 mb s3://<bucket>

Sync directory

bash

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 sync ./local-dir/ s3://<bucket>/remote-dir/

Python (boto3)

python

import boto3
import os

s3 = boto3.client(
    's3',
    endpoint_url='https://s3.hippius.com',
    aws_access_key_id=os.environ['HIPPIUS_S3_ACCESS_KEY'],
    aws_secret_access_key=os.environ['HIPPIUS_S3_SECRET_KEY'],
    region_name='decentralized'
)

# Upload
s3.upload_file('local.txt', 'my-bucket', 'remote.txt')

# Download
s3.download_file('my-bucket', 'remote.txt', 'downloaded.txt')

# List
for obj in s3.list_objects_v2(Bucket='my-bucket').get('Contents', []):
    print(f"{obj['Key']} ({obj['Size']} bytes)")

Scripts

scripts/query_storage.py — Query S3 buckets/objects and RPC account info

Usage:

bash

# List S3 buckets
python scripts/query_storage.py --s3-buckets

# List objects in bucket
python scripts/query_storage.py --s3-objects my-bucket

# Query blockchain credits (requires account address)
python scripts/query_storage.py --account 5Grwva... --credits

References

references/storage_guide.md — S3 vs IPFS comparison, code examples (Python, JS)
references/cli_commands.md — hippius CLI reference (requires self-hosted IPFS node)

Troubleshooting

"Public store.hippius.network has been deprecated" Use S3 instead. The hippius CLI's IPFS commands require a self-hosted IPFS node.

S3 auth errors

Access key must start with hip_
Region must be decentralized (not us-east-1)
Endpoint must be https://s3.hippius.com

External Links

Installation

Terminal bash


openclaw install hippius

Copied!

💻Code Examples

### Upload

-upload.sh

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 cp <file> s3://<bucket>/<key>

### Download

-download.sh

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 cp s3://<bucket>/<key> <local_path>

### Sync directory

-sync-directory.sh

aws --endpoint-url https://s3.hippius.com --region decentralized \
    s3 sync ./local-dir/ s3://<bucket>/remote-dir/

print(f"{obj['Key']} ({obj['Size']} bytes)")

-printfobjkey-objsize-bytes.txt

## Scripts

- `scripts/query_storage.py` — Query S3 buckets/objects and RPC account info

Usage:

example.py

import boto3
import os

s3 = boto3.client(
    's3',
    endpoint_url='https://s3.hippius.com',
    aws_access_key_id=os.environ['HIPPIUS_S3_ACCESS_KEY'],
    aws_secret_access_key=os.environ['HIPPIUS_S3_SECRET_KEY'],
    region_name='decentralized'
)

# Upload
s3.upload_file('local.txt', 'my-bucket', 'remote.txt')

# Download
s3.download_file('my-bucket', 'remote.txt', 'downloaded.txt')

# List
for obj in s3.list_objects_v2(Bucket='my-bucket').get('Contents', []):
    print(f"{obj['Key']} ({obj['Size']} bytes)")

example.sh

# List S3 buckets
python scripts/query_storage.py --s3-buckets

# List objects in bucket
python scripts/query_storage.py --s3-objects my-bucket

# Query blockchain credits (requires account address)
python scripts/query_storage.py --account 5Grwva... --credits