/install hippius
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:
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
aws --endpoint-url https://s3.hippius.com --region decentralized \
s3 cp \x3Cfile> s3://\x3Cbucket>/\x3Ckey>
Download
aws --endpoint-url https://s3.hippius.com --region decentralized \
s3 cp s3://\x3Cbucket>/\x3Ckey> \x3Clocal_path>
List buckets
aws --endpoint-url https://s3.hippius.com --region decentralized s3 ls
List objects
aws --endpoint-url https://s3.hippius.com --region decentralized s3 ls s3://\x3Cbucket>/ --recursive
Create bucket
aws --endpoint-url https://s3.hippius.com --region decentralized s3 mb s3://\x3Cbucket>
Sync directory
aws --endpoint-url https://s3.hippius.com --region decentralized \
s3 sync ./local-dir/ s3://\x3Cbucket>/remote-dir/
Python (boto3)
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:
# 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—hippiusCLI 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(notus-east-1) - Endpoint must be
https://s3.hippius.com
External Links
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install hippius - 安装完成后,直接呼叫该 Skill 的名称或使用
/hippius触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Hippius Storage 是什么?
Hippius decentralized storage on Bittensor Subnet 75 — upload files, query storage, manage buckets via S3-compatible API. Use when user asks to upload to Hippius, check storage status, set up Hippius credentials, list buckets/files, or asks about IPFS vs S3 options. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 850 次。
如何安装 Hippius Storage?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install hippius」即可一键安装,无需额外配置。
Hippius Storage 是免费的吗?
是的,Hippius Storage 完全免费(开源免费),可自由下载、安装和使用。
Hippius Storage 支持哪些平台?
Hippius Storage 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Hippius Storage?
由 maxquick(@maxquick)开发并维护,当前版本 v1.0.1。