ff1-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Feral File
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# FF1-CLI
+
+A small Node.js CLI for building DP-1 playlists from NFT collections.
+
+FF1-CLI turns a simple prompt into a DP-1–conformant playlist you can preview on an FF1. The model orchestrates; deterministic tools do the real work (schema validation, indexing, JSON‑LD). If something comes back invalid, validation rejects it and we loop until it’s right.
+
+## Install
+
+```bash
+npm i -g ff1-cli
+```
+
+## Install (curl)
+
+```bash
+curl -fsSL https://feralfile.com/ff1-cli-install | bash
+```
+
+Installs a prebuilt binary for macOS/Linux (no Node.js required).
+
+## One-off Usage (npx)
+
+```bash
+npx ff1-cli config init
+npx ff1-cli chat
+```
+
+## Quick Start
+
+**Set your LLM API key first (default Grok):** `export GROK_API_KEY='xai-your-api-key-here'`
+
+```bash
+ff1 config init
+ff1 chat
+ff1 play "https://example.com/video.mp4" -d "Living Room Display" --skip-verify
+```
+
+## Dev Quick Start
+
+**Set your LLM API key first (default Grok):** `export GROK_API_KEY='xai-your-api-key-here'`
+
+```bash
+npm install
+npm run dev -- config init
+npm run dev chat
+npm run dev -- play "https://example.com/video.mp4" -d "Living Room Display" --skip-verify
+```
+
+## Documentation
+
+- Getting started, config, and usage: `./docs/README.md`
+- Function calling architecture: `./docs/FUNCTION_CALLING.md`
+- Examples: `./docs/EXAMPLES.md`
+
+## Scripts
+
+```bash
+npm run dev            # Run CLI in dev (tsx)
+npm run build          # Build TypeScript
+npm run lint:fix       # Lint + fix
+```
+
+## License
+
+MIT

package/config.json.example

@@ -0,0 +1,78 @@
+{
+  "defaultModel": "gemini",
+  "models": {
+    "grok": {
+      "apiKey": "YOUR_GROK_API_KEY_FROM_X_AI_CONSOLE",
+      "baseURL": "https://api.x.ai/v1",
+      "model": "grok-4-fast-non-reasoning",
+      "availableModels": [
+        "grok-4-fast-reasoning",
+        "grok-4-fast-non-reasoning",
+        "grok-code-fast-1"
+      ],
+      "timeout": 120000,
+      "maxRetries": 3,
+      "temperature": 0.3,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    },
+    "gpt": {
+      "apiKey": "YOUR_OPENAI_API_KEY_FROM_PLATFORM_OPENAI_COM",
+      "baseURL": "https://api.openai.com/v1",
+      "model": "gpt-4o-mini",
+      "availableModels": [
+        "gpt-4o",
+        "gpt-4o-mini",
+        "gpt-4-turbo"
+      ],
+      "timeout": 30000,
+      "maxRetries": 3,
+      "temperature": 1,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    },
+    "gemini": {
+      "apiKey": "YOUR_GOOGLE_AI_STUDIO_API_KEY_FROM_AISTUDIO_GOOGLE_COM",
+      "baseURL": "https://generativelanguage.googleapis.com/v1beta/openai/",
+      "model": "gemini-2.5-flash",
+      "availableModels": [
+        "gemini-2.5-flash-lite",
+        "gemini-2.5-flash",
+        "gemini-flash-lite-latest"
+      ],
+      "timeout": 30000,
+      "maxRetries": 3,
+      "temperature": 0.3,
+      "maxTokens": 4000,
+      "supportsFunctionCalling": true
+    }
+  },
+  "defaultDuration": 10,
+  "browser": {
+    "timeout": 90000,
+    "sanitizationLevel": "medium"
+  },
+  "feedServers": [
+    {
+      "baseUrl": "https://feed.feralfile.com/api/v1",
+      "apiKey": "YOUR_FEED_SERVER_API_KEY_OPTIONAL"
+    },
+    {
+      "baseUrl": "http://localhost:8787",
+      "apiKey": "YOUR_FEED_SERVER_API_KEY_OPTIONAL"
+    }
+  ],
+  "playlist": {
+    "privateKey": "YOUR_ED25519_PRIVATE_KEY_BASE64_ENCODED_RUN_NODE_INDEX_JS_GENERATE_KEYS"
+  },
+  "ff1Devices": {
+    "devices": [
+      {
+        "name": "DISPLAY_NAME_FOR_YOUR_FF1_DEVICE",
+        "host": "http://YOUR_FF1_IP_ADDRESS:1111",
+        "apiKey": "YOUR_FF1_DEVICE_API_KEY_FROM_DEVICE_SETTINGS",
+        "topicID": "YOUR_FF1_DEVICE_TOPIC_ID_FROM_DEVICE_SETTINGS"
+      }
+    ]
+  }
+}