Replicate Predictions Downloader (Python)

Download and organize all your Replicate predictions, including images, videos, 3D models, and metadata.

Why

Replicate doesn't keep your prediction data forever. Per their data retention policy, predictions created via the API have their inputs, outputs, files, and logs automatically removed after one hour by default. Predictions made on the website are kept indefinitely, but output files still need downloading if you want local copies. This tool grabs everything while it's still there.

Features

• Batch download all your Replicate prediction outputs
• Organize by model into clean directory structures
• Smart filenames with dates, model names, and prompt snippets
• ZIP archives for each model for easy backup
• Date filtering - download predictions from specific time ranges
• Incremental downloads - only fetch new predictions since last run
• Full metadata export as JSON

Installation

pip install replicate-predictions-downloader

Or with pipx for isolated CLI usage:

pipx install replicate-predictions-downloader

Setup

1. Get your API token from replicate.com/account/api-tokens

2. Set your token:

   export REPLICATE_API_TOKEN=your_token_here
   

   Or create a .env file:

   REPLICATE_API_TOKEN=your_token_here
   

Usage

Download all predictions

replicate-downloader

Download predictions from a specific date

replicate-downloader --since "2024-01-15"
replicate-downloader --since "7 days ago"
replicate-downloader --since yesterday

Download predictions in a date range

replicate-downloader --since "2024-01-01" --until "2024-06-30"

Incremental download (since last run)

replicate-downloader --last-run

Output Structure

replicate_outputs_2024-01-15/
├── by-model/
│   ├── stable-diffusion/
│   │   ├── 2024-01-15_stable-diffusion_a-photo-of-an-astronaut_abc123.png
│   │   ├── 2024-01-15_stable-diffusion_sunset-over-mountains_def456.png
│   │   └── abc123_metadata.json
│   ├── stable-diffusion.zip
│   ├── flux-pro/
│   │   └── ...
│   └── flux-pro.zip
└── replicate_metadata_2024-01-15.json

Python API

You can also use the downloader programmatically:

from replicate_downloader import ReplicateDownloader

downloader = ReplicateDownloader(
    api_token="your_token",  # or use REPLICATE_API_TOKEN env var
    since="7 days ago",
)
downloader.run()

Options

Date Formats

The --since and --until options support:

• ISO format: 2024-01-15
• Relative: yesterday, 7 days ago, 2 weeks ago, 1 month ago

Related

• replicate-predictions-downloader - Node.js version
• Replicate Python SDK

License

MIT