replicate-predictions-downloader 2.0.0 → 2.0.2

package/README.md

@@ -1,8 +1,8 @@
-# Replicate Predictions Downloader
+# Replicate Predictions Downloader 
 
 A Node.js script to download and organize all your Replicate predictions, including images, metadata, and other outputs before they expire.
 
-![Replicate Downloader Banner](https://replicate.com/static/favicon.png)
+![Replicate Downloader Banner](replicate-prediction-banner.png)
 
 <div align="center">
 
@@ -17,19 +17,31 @@ A Node.js script to download and organize all your Replicate predictions, includ
 
 ## Features
 
-- 📥 Downloads all predictions from your Replicate account
-- 🗂️ Organizes files by model and date
-- 📅 **NEW: Date filtering** to avoid duplicate downloads
-- 🔄 **NEW: Incremental downloads** since last successful run
-- 🗜️ Creates ZIP archives for each model (optional)
-- 📊 Saves enhanced metadata for all predictions
-- 📈 Shows detailed download statistics
-- ⏱️ Preserves predictions before they expire
+- Downloads all predictions from your Replicate account
+- Organizes files by model and date
+- Date filtering to avoid duplicate downloads
+- Incremental downloads since last successful run
+- Creates ZIP archives for each model (optional)
+- Saves enhanced metadata for all predictions
+- Shows detailed download statistics
+- Preserves predictions before they expire
+
+## Quick Start
+
+```bash
+npx replicate-predictions-downloader --last-run
+```
+
+You'll need your API token from [replicate.com/account/api-tokens](https://replicate.com/account/api-tokens) in the environment as `REPLICATE_API_TOKEN`.
 
 ## Why Use This Tool?
 
 Replicate only stores your predictions temporarily. This tool helps you preserve your valuable work before it disappears, with intelligent organization to make your outputs easy to find later.
 
+## Background
+
+Replicate deletes predictions after 30 days. If you've been experimenting with models and want to keep your outputs - for portfolios, research, or just because you like them - you need to download them yourself. This tool does that, with some organization thrown in so you can actually find things later.
+
 ## Setup
 
 ### Prerequisites
@@ -88,6 +100,10 @@ node index.js
 replicate-downloader
 ```
 
+## What You'll See
+
+When you run the tool, you'll see real-time progress as it fetches and downloads your predictions. The output includes details about what's being processed, download progress, and final statistics. Your files end up organized by model and date. There's also a metadata JSON if you're into that sort of thing.
+
 ### Date Filtering Options
 
 Avoid duplicate downloads with intelligent date filtering:
@@ -202,6 +218,32 @@ The included .gitignore will help prevent this.
 
 This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
 
-## Background
 
-This tool was created while working on LLM behavior/personality research to preserve valuable predictions before they expired.
+## Common Issues
+
+**"Invalid API token" or "Authentication failed"**
+- Double-check your token at [replicate.com/account/api-tokens](https://replicate.com/account/api-tokens)
+- Make sure you've set `REPLICATE_API_TOKEN` in your environment or `.env` file
+- Try: `echo $REPLICATE_API_TOKEN` to verify it's set
+
+**"Network timeout" or connection errors**
+- Check your internet connection
+- The tool automatically retries failed downloads
+- For persistent issues, try running with fewer concurrent requests by editing the CONFIG object
+
+**"Permission denied" or file errors**
+- Ensure you have write permissions in the current directory
+- On Windows, try running as administrator if needed
+- Make sure you have enough disk space for your downloads
+
+**"No new predictions found"**
+- If using `--last-run`, this means you're up to date!
+- Try `--since "1 week ago"` to see recent predictions
+- Use `--all` to redownload everything (may create duplicates)
+
+**Files have weird names or special characters**
+- The tool automatically sanitizes filenames
+- Prompts longer than the limit (default: 50 chars) are truncated
+- Adjust `maxPromptLength` in CONFIG if needed
+
+**Need help?** Check existing [GitHub issues](https://github.com/closestfriend/replicate-predictions-downloader/issues) or create a new one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicate-predictions-downloader",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "A Node.js script to download and organize all your Replicate predictions, including images, metadata, and other outputs",
   "main": "index.js",
   "type": "module",
@@ -17,7 +17,14 @@
     "predictions",
     "organization",
     "replicate-api",
-    "model-outputs"
+    "model-outputs",
+    "stable-diffusion",
+    "midjourney-alternative",
+    "ai-art",
+    "batch-download",
+    "backup",
+    "archive",
+    "cli"
   ],
   "author": "closestfriend",
   "license": "MIT",