all-the-public-replicate-models 1.41.0 → 1.43.0

package/README.md

@@ -8,7 +8,7 @@ Metadata for all the public models on Replicate, bundled up into an npm package.
 npm install all-the-public-replicate-models
 ```
 
-## Usage
+## Usage (as a library)
 
 Full-bodied usage (all the metadata, ~17MB)
 
@@ -35,3 +35,42 @@ import {chain} from 'lodash-es'
 const mostRun = chain(models).orderBy('run_count', 'desc').take(10).value()
 console.log({mostRun})
 ```
+
+## Usage (as a CLI)
+
+The CLI dumps the model metadata to standard output as a big JSON object:
+
+```command
+$ npx all-the-public-replicate-models
+```
+
+The output will be:
+
+```
+[
+  {...},
+  {...},
+  {...},
+]
+```
+
+You can use [jq](https://stedolan.github.io/jq/) to filter the output. Here's an example that finds all the whisper models and sorts them by run count:
+
+```command
+npx all-the-public-replicate-models | jq -r 'map(select(.name | contains("whisper"))) | sort_by(.run_count) | reverse | .[] | "\(.url) \(.run_count)"'
+```
+
+- https://replicate.com/openai/whisper 3790120
+- https://replicate.com/m1guelpf/whisper-subtitles 38020
+- https://replicate.com/hnesk/whisper-wordtimestamps 28889
+- https://replicate.com/alqasemy2020/whisper-jax 20296
+- https://replicate.com/wglodell/cog-whisperx-withprompt 19326
+- https://replicate.com/daanelson/whisperx 15528
+...
+
+
+Or you can dump all the model data to a file:
+
+```command
+npx all-the-public-replicate-models > models.json
+```

package/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import models from './index.mjs';
+
+process.stdout.write(JSON.stringify(models, null, 2));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "all-the-public-replicate-models",
   "description": "Metadata for all the public models on Replicate, bundled up into an npm package",
-  "version": "1.41.0",
+  "version": "1.43.0",
   "devDependencies": {
     "chai": "^4.3.10",
     "lodash-es": "^4.17.21",
@@ -20,5 +20,10 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "bin": {
+    "all-the-public-replicate-models": "cli.js",
+    "all-the-replicate-models": "cli.js",
+    "replicate-models": "cli.js"
   }
 }