Developers

ICPay Bucket SDK: npm, Python & Go Clients

ICPay Cloud stores files inside the backend canister on the Internet Computer. These three packages talk to the same API — pick the one that fits your stack.

August 16, 2026 · 5 min read

Available packages

All clients target canister 6vbhm-nqaaa-aaaan-q6muq-cai on mainnet. Version 1.1.1 covers uploads, downloads, chunked files, API keys, and bucket management.

TypeScript / Node
npm
```
npm install icpay-bucket
```
Registry Source
Python
PyPI
```
pip install icpay-bucket
```
Registry Source

Go modules

go get github.com/prasangapokharel/icpay-bucket-go

Registry Source

TypeScript quick start

import { BucketClient } from "icpay-bucket"

const client = new BucketClient({ apiKey: process.env.BUCKET_API_KEY })
const up = await client.uploadFile({
  bucketId: "my-bucket",
  path: "/hello.txt",
  data: new TextEncoder().encode("hello\n"),
  contentType: "text/plain",
})
console.log(client.publicUrl("my-bucket", "/hello.txt"))

What you need first

An ICPay account with a bucket — create one under Bucket.
An API key with the scopes your script needs (read, write, or delete).
For browser apps, prefer read-only keys and never embed a delete key in client code.

More docs

The in-app reference lists every canister method with curl, TypeScript, and Python examples: Bucket API docs. For storage concepts, read ICP cloud storage explained, or browse all blog posts.