nopenix/replicate-safe repository overview

⁠Replicate-Safe

Two small Docker containers that continuously download every prediction and its output files from your Replicate account into a local folder, then serve a browser UI to browse and preview them.

⁠Quick start

mkdir replicate-safe && cd replicate-safe

cat > .env <<'EOF'
REPLICATE_API_TOKEN=r8_your_token_here
POLL_INTERVAL=900
LOG_LEVEL=info
EOF

curl -O https://raw.githubusercontent.com/NopeNix/Replicate-Safe/main/docker-compose.yml
docker compose up -d
docker compose logs -f

Open http://localhost:8080⁠. The daemon writes predictions and outputs into ./data/, prefixed with the prediction id so nothing collides:

data/
├── .state.json
├── 01w9p8j4pdrmw0czsr3bcwtyh4__00_tmpagwigfij.png
├── 01w9p8j4pdrmw0czsr3bcwtyh4.metadata.json
└── ...

⁠docker-compose.yml

services:
  replicate-safe:
    image: nopenix/replicate-safe:latest
    restart: unless-stopped
    env_file: [.env]
    environment:
      OUTPUT_DIR: /data
      STATE_FILE: /data/.state.json
    volumes: [./data:/data]

  frontend:
    image: nopenix/replicate-safe-frontend:latest
    restart: unless-stopped
    depends_on: [replicate-safe]
    environment:
      DATA_DIR: /data
      LISTEN_ADDR: ":8080"
    ports: ["8080:8080"]
    volumes: [./data:/data:ro]

The frontend mounts the data volume read-only — it can never write to your backups even if compromised.

⁠Configuration

⁠Daemon (replicate-safe)

⁠Frontend (replicate-safe-frontend)

⁠UI features

• File explorer with thumbnail, filename, created, model, status, time-to-make, size columns
• Sort any column by clicking its header (asc/desc); default = newest first
• Search the full metadata.json content — prompt text, model name, version, raw API response
• Preview native image / video / audio; iframe for text; download link for other types
• Zoom the big preview with the mouse wheel, drag to pan, +/−/0 keyboard shortcuts
• Download or Convert (JPG / PNG / GIF / BMP / TIFF) any image
• Share to Telegram or WhatsApp, Copy link, Copy image to clipboard
• Resizable split between panels, resizable metadata panel, resizable columns in the explorer
• Theme follows system by default; ◐ button cycles auto / light / dark
• Footer links to GitHub and Docker Hub

All UI state (panel widths, column widths, zoom, theme, thumbnail size) is persisted in localStorage so your layout survives reloads.

⁠Frontend API

⁠Caveats

1. Replicate purges prediction inputs/outputs ~1 hour after creation for API-created predictions. Old predictions return data_removed=true and the output URLs 404 — the metadata is still saved but the files are gone. Run the container continuously to catch outputs before they expire.
2. Web-created predictions are queryable for only the last 14 days.
3. The token must belong to the account that owns the predictions.
4. Rate limits apply (~600 req/min). Steady-state usage is minimal: 1 list request per pass + 1 request per new file.
5. A flat directory works fine up to a few thousand files. For hundreds of thousands, a sub-dirs-by-date layout would be needed.
6. Make sure the mounted volume has enough space — outputs can be large.

⁠Building from source

Both Docker Hub images are built from this repo by GitHub Actions on every push to main. To hack locally:

git clone https://github.com/NopeNix/Replicate-Safe.git
cd Replicate-Safe

go run .                              # daemon
docker build -t replicate-safe:dev .

go run ./frontend                     # frontend on :8080
docker build -f frontend/Dockerfile -t replicate-safe-frontend:dev .

docker compose up -d

⁠License

See LICENSE⁠.