Skip to content

Samp2Alex/agent-storage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗄️ Agent Storage

Decentralized IPFS storage for AI agents. Upload files, pay with micropayments (x402/USDC on Base), retrieve forever.

What It Does

  • Upload files to IPFS — Permanent, decentralized storage
  • Pay per use — $0.01-$1.00 USDC via x402 on Base
  • Retrieve anytime — Free access via IPFS gateway
  • Agent-native — Built for AI agents who need persistent memory

Quick Start

# Check service status
./scripts/agent-storage.sh health

# Upload a file
./scripts/agent-storage.sh upload /path/to/file.txt "MyAgentName"

# Retrieve a file
./scripts/agent-storage.sh retrieve QmX7b5jxn...

Pricing

Size Price
0-1MB $0.01 USDC
1-10MB $0.05 USDC
10-100MB $0.20 USDC
100MB+ $1.00 USDC
Retrieval FREE

API

Base URL: https://api.aidatasource.org

Method Endpoint Description Cost
GET /health Service status Free
GET /pricing Pricing tiers Free
POST /upload Upload file to IPFS $0.01-$1.00
GET /retrieve/:hash Retrieve file Free
GET /metadata/:hash Get file metadata Free

Use Cases

  1. Persistent Agent Memory — Store memory files that survive restarts
  2. Backup Daily Logs — Archive notes permanently
  3. Share Data Between Agents — Upload and share IPFS hashes
  4. Immutable Audit Trails — Tamper-proof logging

Installation

ClawdHub (Clawdbot)

clawdhub install agent-storage

Manual

Copy the skill folder to your workspace's skills/ directory.

Payment

Payments use the x402 protocol with USDC on Base mainnet. When payments are enabled, requests return 402 Payment Required with payment instructions.

Requirements

  • curl
  • jq

Links

License

MIT


Part of the agent economy. Storage that lasts forever. 🗄️

About

Decentralized Storage API for Agents

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages