File sharing for agents & CLI

For AI assistants & agents

Point your agent to this page. Even simple models can follow these instructions.

HOW TO SHARE A FILE VIA GOOI.IO
================================

You are an agent that needs to share a file with a user.
gooi.io lets you upload an encrypted file and get a shareable link.
The file is encrypted on your machine — the server cannot read it.

Pick the option that fits your environment:

OPTION A — Bash CLI (recommended for shell agents, CI/CD, servers):

    curl -sO https://agents.gooi.io/gooi && chmod +x gooi
    ./gooi /path/to/file.ext

    Requires: bash, curl, openssl, and one of:
      - python3 + cryptography (pip install cryptography), OR
      - node.js (v16+)

    The CLI auto-detects which crypto backend is available.

    Example output:
      ▸ Uploaden: report.pdf (2 MiB, 1 chunk(s), sha256:a1b2c3d4...)
      ▸ Crypto backend: node
      ▸   Chunk 1/1
      ✓ Upload voltooid
        https://gooi.io/d/xR9kLm3pQw7n#base64urlkey

OPTION B — Python SDK (for ChatGPT, code interpreters, Python agents):

    curl -sO https://agents.gooi.io/gooi-sdk.py
    python3 gooi-sdk.py --file /path/to/file.ext

    Or as a module (e.g. in a code interpreter sandbox):
        from gooi_sdk import upload
        result = upload("/path/to/file.ext")
        print(result["url"])

    Requires: python3 + cryptography (pip install cryptography)

OPTION C — Node.js SDK:

    curl -sO https://agents.gooi.io/gooi-sdk.mjs
    node gooi-sdk.mjs --file /path/to/file.ext

    Or as a module:
        import { upload } from './gooi-sdk.mjs';
        const result = await upload({ file: '/path/to/file.ext' });

    Requires: node.js 16+

THE RESULT — a shareable URL:

    https://gooi.io/d/abc123#base64urlkey

    Share this URL with the user. Anyone with the link can
    download and decrypt the file in their browser. No account needed.

NOTES:
- Max file size: 5 GB (up to 100 GB with a VIG API key)
- Files expire after 24 hours (up to 30 days with VIG)
- For files >5 GiB, pass --api-key or set GOOI_API_KEY.
  In non-interactive use (pipes, cron, --json) the CLI exits cleanly
  with exit code 3 instead of prompting.
- The #fragment (after #) is the decryption key — it never goes to the server
- All three options produce identical encryption, compatible with the browser