@telepat/rilo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Telepat contributors
+
+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,209 @@
+# Rilo
+
+[![CI](https://github.com/telepat-io/rilo/actions/workflows/ci.yml/badge.svg)](https://github.com/telepat-io/rilo/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/telepat-io/rilo/graph/badge.svg)](https://codecov.io/gh/telepat-io/rilo)
+[![npm version](https://img.shields.io/npm/v/%40telepat%2Frilo)](https://www.npmjs.com/package/@telepat/rilo)
+[![npm downloads](https://img.shields.io/npm/dm/%40telepat%2Frilo)](https://www.npmjs.com/package/@telepat/rilo)
+[![Docs](https://img.shields.io/badge/docs-live-22c55e)](https://docs.telepat.io/rilo/)
+[![License](https://img.shields.io/github/license/telepat-io/rilo)](./LICENSE)
+
+Story-first vertical video generation.
+
+Rilo turns one story into a complete short-form video pipeline:
+- script generation
+- voiceover generation
+- keyframe generation
+- video segment generation
+- final composition
+- optional subtitle alignment and burn-in
+
+## Why Rilo
+
+- Built for vertical video workflows
+- Checkpointed runs with resume support
+- Targeted regeneration for faster iteration
+- Model selection and per-model option overrides
+- Local and Firebase output backends
+- API, worker, and frontend flow for production usage
+
+## Quick Start
+
+Requirements:
+- Node.js 22+
+- ffmpeg in PATH
+- Replicate API token
+
+Setup:
+
+```bash
+npm install
+cp .env.example .env
+```
+
+Set required environment variables in .env, **or use the interactive settings command** (see below):
+
+```bash
+RILO_REPLICATE_API_TOKEN=your-token
+RILO_API_BEARER_TOKEN=your-api-bearer-token
+```
+
+Run the full local stack:
+
+```bash
+npm run dev:all
+```
+
+Run a CLI generation:
+
+```bash
+rilo --project demo --story-file ./story.txt
+```
+
+## Settings
+
+Configure rilo interactively without editing files:
+
+```bash
+rilo settings
+```
+
+For local development in this repository:
+
+```bash
+npm run dev -- settings
+npm run dev -- --project demo --story-file ./story.txt
+```
+
+This opens a menu where you can edit all non-sensitive settings and manage API tokens securely. Navigate with arrow keys, select with Enter, and use "Done" or "Cancel" to exit. You can also press Ctrl+C at any time to quit.
+
+**What gets stored where:**
+
+| Setting type | Storage |
+|---|---|
+| Replicate API Token, API Bearer Token | OS keystore (macOS Keychain, Windows Credential Manager, Linux Secret Service) — or an AES-256 encrypted file at `~/.rilo/.secrets` if no native keystore is available |
+| All other settings (timeouts, limits, binary paths, etc.) | `~/.rilo/config.json` |
+
+**Precedence** (highest → lowest): environment variable > `~/.rilo/config.json` > schema default.  
+If an env var is set, the settings command shows it as read-only and any stored value is ignored while the env var is present.
+
+**Hidden from settings UI** (env-only): Firebase credentials, webhook settings, output backend, API port, custom output/projects directories.
+
+## Install from npm
+
+```bash
+npm install -g @telepat/rilo
+rilo --help
+```
+
+Or without global install:
+
+```bash
+npx @telepat/rilo --help
+```
+
+## CLI Quick Reference
+
+### Generate a video from a story
+
+```bash
+rilo --project <name> --story-file <path>
+```
+
+Examples:
+```bash
+# First run: create project and start generation
+rilo --project wedding-case --story-file ./story.txt
+
+# On subsequent runs: reuse story
+rilo --project wedding-case
+
+# Force restart from earlier stages (after config change)
+rilo --project wedding-case --force
+```
+
+### Configure settings
+
+```bash
+rilo settings
+```
+
+Opens an interactive menu to set API tokens, timeouts, and binary paths.
+
+### Open the Rilo home folder
+
+```bash
+rilo home
+```
+
+Opens `~/.rilo`, the default location for saved settings, projects, and generated output.
+
+### Help and version
+
+```bash
+rilo --help                    # Show usage
+rilo --version                 # Show version
+```
+
+### Invocation methods
+
+| Method | Command |
+|--------|---------|
+| **Global install** | `rilo --project <name> --story-file <path>` |
+| **No install (npx)** | `npx @telepat/rilo --project <name> --story-file <path>` |
+| **Local dev** | `npm run dev -- --project <name> --story-file <path>` |
+
+### Key flags
+
+| Flag | Type | Notes |
+|------|------|-------|
+| `--project` | `<name>` | **Required.** Project identifier; creates `projects/<name>/` |
+| `--story-file` | `<path>` | Path to story text file (required on first run) |
+| `--force` | flag | Restart from earlier stages; used after config changes |
+
+### Common tasks
+
+**Update project config and regenerate:**
+```bash
+# Edit projects/wedding-case/config.json (aspect ratio, models, etc.)
+rilo --project wedding-case --force
+```
+
+**Change app settings (tokens, timeouts, binary paths):**
+```bash
+rilo settings
+# Arrow keys to navigate, Enter to edit, "Done" to save
+```
+
+**Open the default app folder for projects/output:**
+```bash
+rilo home
+# Opens ~/.rilo in your system file manager
+```
+
+**Check where generated files are stored:**
+```bash
+ls projects/wedding-case/
+# Outputs: config.json, story.md, final.mp4, artifacts.json, run-state.json, assets/, logs/
+```
+
+---
+
+## CLI Documentation
+
+For comprehensive CLI documentation, see:
+- **[Quickstart](/docs.telepat.io/rilo/getting-started/quickstart)** — Step-by-step guide to your first generation
+- **[CLI Reference](/docs.telepat.io/rilo/reference/cli-reference)** — All commands, flags, and invocation methods
+- **[Complete Config Schema](/docs.telepat.io/rilo/reference/config-schema)** — Every config key with types and defaults
+- **[Configuration Guide](/docs.telepat.io/rilo/guides/configuration)** — Project and app settings with examples
+- **[Troubleshooting](/docs.telepat.io/rilo/guides/troubleshooting)** — Common errors and solutions
+- **[Environment Variables](/docs.telepat.io/rilo/reference/environment-variables)** — Setting precedence and env var reference
+
+## Full Documentation
+
+Guides, API reference, architecture notes, and advanced configuration:
+
+https://docs.telepat.io/rilo/
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1 @@
+export { api } from './src/api/firebaseFunction.js';

package/models/black-forest-labs__flux-2-pro.json

@@ -0,0 +1,78 @@
+{
+  "modelId": "black-forest-labs/flux-2-pro",
+  "provider": "replicate",
+  "displayName": "FLUX 2 Pro",
+  "category": "image-generation",
+  "pricingSourceUrl": "https://replicate.com/black-forest-labs/flux-2-pro",
+  "pricingNotes": "Replicate lists multi-property pricing for run and input/output megapixels; this model currently uses best-effort cost fallback when exact rule mapping is unavailable.",
+  "pricing": {
+    "usdPerSecond": null,
+    "usdPer1kInputTokens": null,
+    "usdPer1kOutputTokens": null
+  },
+  "inputOptions": {
+    "userConfigurable": [
+      "safety_tolerance",
+      "seed",
+      "output_format",
+      "output_quality"
+    ],
+    "pipelineManaged": [
+      "prompt",
+      "aspect_ratio",
+      "width",
+      "height"
+    ],
+    "fields": {
+      "safety_tolerance": {
+        "type": "integer",
+        "default": 2,
+        "minimum": 1,
+        "maximum": 5
+      },
+      "seed": {
+        "type": "integer",
+        "nullable": true
+      },
+      "output_format": {
+        "type": "string",
+        "default": "webp",
+        "enum": [
+          "webp",
+          "png",
+          "jpg",
+          "jpeg"
+        ]
+      },
+      "output_quality": {
+        "type": "integer",
+        "default": 80,
+        "minimum": 0,
+        "maximum": 100
+      },
+      "prompt": {
+        "type": "string",
+        "required": true
+      },
+      "aspect_ratio": {
+        "type": "string",
+        "required": true,
+        "enum": [
+          "custom"
+        ]
+      },
+      "width": {
+        "type": "integer",
+        "required": true,
+        "minimum": 256,
+        "maximum": 2048
+      },
+      "height": {
+        "type": "integer",
+        "required": true,
+        "minimum": 256,
+        "maximum": 2048
+      }
+    }
+  }
+}

package/models/black-forest-labs__flux-schnell.json

@@ -0,0 +1,95 @@
+{
+  "modelId": "black-forest-labs/flux-schnell",
+  "provider": "replicate",
+  "displayName": "FLUX Schnell",
+  "category": "image-generation",
+  "pricingSourceUrl": "https://replicate.com/black-forest-labs/flux-schnell",
+  "pricingNotes": "Replicate pricing: $3 per 1000 output images.",
+  "pricing": {
+    "usdPerSecond": null,
+    "usdPer1kInputTokens": null,
+    "usdPer1kOutputTokens": null
+  },
+  "pricingRules": {
+    "basis": "output_image_count",
+    "usdPerImage": 0.003
+  },
+  "inputOptions": {
+    "userConfigurable": [
+      "num_outputs",
+      "num_inference_steps",
+      "seed",
+      "output_format",
+      "output_quality",
+      "disable_safety_checker",
+      "go_fast",
+      "megapixels"
+    ],
+    "pipelineManaged": [
+      "prompt",
+      "aspect_ratio"
+    ],
+    "fields": {
+      "num_outputs": {
+        "type": "integer",
+        "default": 1,
+        "minimum": 1,
+        "maximum": 4
+      },
+      "num_inference_steps": {
+        "type": "integer",
+        "default": 4,
+        "minimum": 1,
+        "maximum": 4
+      },
+      "seed": {
+        "type": "integer",
+        "nullable": true
+      },
+      "output_format": {
+        "type": "string",
+        "default": "webp",
+        "enum": [
+          "webp",
+          "jpg",
+          "png"
+        ]
+      },
+      "output_quality": {
+        "type": "integer",
+        "default": 80,
+        "minimum": 0,
+        "maximum": 100
+      },
+      "disable_safety_checker": {
+        "type": "boolean",
+        "default": false
+      },
+      "go_fast": {
+        "type": "boolean",
+        "default": true
+      },
+      "megapixels": {
+        "type": "string",
+        "default": "1",
+        "allowAnyString": true,
+        "recommendedValues": [
+          "1"
+        ]
+      },
+      "prompt": {
+        "type": "string",
+        "required": true
+      },
+      "aspect_ratio": {
+        "type": "string",
+        "required": true,
+        "enum": [
+          "1:1",
+          "16:9",
+          "9:16"
+        ]
+      }
+    }
+  }
+}

package/models/bytedance__seedream-4.json

@@ -0,0 +1,71 @@
+{
+  "modelId": "bytedance/seedream-4",
+  "provider": "replicate",
+  "displayName": "Seedream 4",
+  "category": "image-generation",
+  "pricingSourceUrl": "https://replicate.com/bytedance/seedream-4",
+  "pricingNotes": "Replicate pricing: $0.03 per output image.",
+  "pricing": {
+    "usdPerSecond": null,
+    "usdPer1kInputTokens": null,
+    "usdPer1kOutputTokens": null
+  },
+  "pricingRules": {
+    "basis": "output_image_count",
+    "usdPerImage": 0.03
+  },
+  "inputOptions": {
+    "userConfigurable": [
+      "size",
+      "sequential_image_generation",
+      "max_images",
+      "enhance_prompt"
+    ],
+    "pipelineManaged": [
+      "prompt",
+      "aspect_ratio"
+    ],
+    "fields": {
+      "size": {
+        "type": "string",
+        "default": "2K",
+        "enum": [
+          "1K",
+          "2K",
+          "4K"
+        ]
+      },
+      "sequential_image_generation": {
+        "type": "string",
+        "default": "disabled",
+        "enum": [
+          "disabled",
+          "auto"
+        ]
+      },
+      "max_images": {
+        "type": "integer",
+        "default": 1,
+        "minimum": 1,
+        "maximum": 15
+      },
+      "enhance_prompt": {
+        "type": "boolean",
+        "default": true
+      },
+      "prompt": {
+        "type": "string",
+        "required": true
+      },
+      "aspect_ratio": {
+        "type": "string",
+        "required": true,
+        "enum": [
+          "1:1",
+          "16:9",
+          "9:16"
+        ]
+      }
+    }
+  }
+}

package/models/deepseek-ai__deepseek-v3.json

@@ -0,0 +1,61 @@
+{
+  "modelId": "deepseek-ai/deepseek-v3",
+  "provider": "replicate",
+  "displayName": "DeepSeek V3",
+  "category": "text-generation",
+  "pricingSourceUrl": "https://replicate.com/deepseek-ai/deepseek-v3",
+  "pricingNotes": "Replicate page lists both input and output at $1.45 per million tokens.",
+  "pricing": {
+    "usdPerSecond": null,
+    "usdPer1kInputTokens": 0.00145,
+    "usdPer1kOutputTokens": 0.00145
+  },
+  "inputOptions": {
+    "userConfigurable": [
+      "max_tokens",
+      "temperature",
+      "presence_penalty",
+      "frequency_penalty",
+      "top_p"
+    ],
+    "pipelineManaged": [
+      "prompt"
+    ],
+    "fields": {
+      "max_tokens": {
+        "type": "integer",
+        "default": 2048,
+        "minimum": 1,
+        "maximum": 8192
+      },
+      "temperature": {
+        "type": "number",
+        "default": 0.1,
+        "minimum": 0,
+        "maximum": 2
+      },
+      "presence_penalty": {
+        "type": "number",
+        "default": 0,
+        "minimum": -2,
+        "maximum": 2
+      },
+      "frequency_penalty": {
+        "type": "number",
+        "default": 0,
+        "minimum": -2,
+        "maximum": 2
+      },
+      "top_p": {
+        "type": "number",
+        "default": 1,
+        "minimum": 0,
+        "maximum": 1
+      },
+      "prompt": {
+        "type": "string",
+        "required": true
+      }
+    }
+  }
+}

package/models/google__nano-banana-pro.json

@@ -0,0 +1,92 @@
+{
+  "modelId": "google/nano-banana-pro",
+  "provider": "replicate",
+  "displayName": "Nano Banana Pro",
+  "category": "image-generation",
+  "pricingSourceUrl": "https://replicate.com/google/nano-banana-pro",
+  "pricingNotes": "Replicate pricing by target resolution: 1K/2K=$0.15 per output image, 4K=$0.30 per output image, fallback tier=$0.035 per output image.",
+  "pricing": {
+    "usdPerSecond": null,
+    "usdPer1kInputTokens": null,
+    "usdPer1kOutputTokens": null
+  },
+  "pricingRules": {
+    "basis": "output_image_resolution",
+    "tiers": [
+      {
+        "resolution": "1K",
+        "usdPerImage": 0.15
+      },
+      {
+        "resolution": "2K",
+        "usdPerImage": 0.15
+      },
+      {
+        "resolution": "4K",
+        "usdPerImage": 0.3
+      },
+      {
+        "resolution": "fallback",
+        "usdPerImage": 0.035
+      }
+    ]
+  },
+  "inputOptions": {
+    "userConfigurable": [
+      "resolution",
+      "output_format",
+      "safety_filter_level",
+      "allow_fallback_model"
+    ],
+    "pipelineManaged": [
+      "prompt",
+      "aspect_ratio"
+    ],
+    "fields": {
+      "resolution": {
+        "type": "string",
+        "default": "2K",
+        "enum": [
+          "1K",
+          "2K",
+          "4K"
+        ]
+      },
+      "output_format": {
+        "type": "string",
+        "default": "jpg",
+        "enum": [
+          "jpg",
+          "png",
+          "webp"
+        ]
+      },
+      "safety_filter_level": {
+        "type": "string",
+        "default": "block_only_high",
+        "enum": [
+          "block_low_and_above",
+          "block_medium_and_above",
+          "block_only_high"
+        ]
+      },
+      "allow_fallback_model": {
+        "type": "boolean",
+        "default": false
+      },
+      "prompt": {
+        "type": "string",
+        "required": true
+      },
+      "aspect_ratio": {
+        "type": "string",
+        "required": true,
+        "enum": [
+          "1:1",
+          "16:9",
+          "9:16"
+        ]
+      }
+    }
+  }
+}