Update README.md
This commit is contained in:
GitHub
73
README.md
73
README.md
@@ -3,24 +3,31 @@
|
||||
A 100% vibecoded, visual dashboard for managing, versioning, and batch-processing JSON configuration files used in AI video generation workflows (I2V, VACE).
|
||||
|
||||
This tool consists of two parts:
|
||||
1. **Streamlit Web Interface:** A Dockerized editor to manage prompts, LoRAs, and settings.
|
||||
2. **ComfyUI Custom Nodes:** A set of nodes to read these JSON files directly into your workflows.
|
||||
1. **Streamlit Web Interface:** A Dockerized editor to manage prompts, LoRAs, settings, and **branching history**.
|
||||
2. **ComfyUI Custom Nodes:** A set of nodes to read these JSON files (including custom keys) directly into your workflows.
|
||||
|
||||
  
|
||||
---
|
||||
|
||||
## ✨ Features
|
||||
|
||||
### 📝 Single File Editor
|
||||
* **Visual Interface:** Edit Prompts, Negative Prompts, Seeds, LoRAs, and advanced settings (Camera, FLF, VACE params) without touching raw JSON.
|
||||
* **Smart History:** Every save allows you to create a "Snapshot." You can view, restore, or edit historical versions of your prompts instantly.
|
||||
* **🔧 Custom Parameters:** Add arbitrary key-value pairs (e.g., `controlnet_strength`, `my_custom_value`) that persist and can be read by ComfyUI.
|
||||
* **Conflict Protection:** Prevents accidental overwrites if the file is modified by another tab or process.
|
||||
* **Snippet Library:** Save reusable prompt fragments (e.g., "Cinematic Lighting", "Anime Style") and append them with one click.
|
||||
|
||||
### 🚀 Batch Processor
|
||||
* **Sequence Management:** Create unlimited sequences within a single JSON file.
|
||||
* **Import Tools:** Copy settings from **any other file** or **history entry** into your current batch sequence.
|
||||
* **Promote to Single:** Liked a specific shot in your batch? One-click convert a sequence back into a standalone Single File.
|
||||
* **Infinite Looping:** ComfyUI nodes automatically loop through sequences (modulo logic), allowing for infinite generation runs.
|
||||
* **Smart Import:** Copy settings from **any other file** or **history entry** into your current batch sequence.
|
||||
* **Custom Keys per Shot:** Define unique parameters for specific shots in a batch (e.g., Shot 1 has `fog: 0.5`, Shot 2 has `fog: 0.0`).
|
||||
* **Promote to Single:** One-click convert a specific batch sequence back into a standalone Single File.
|
||||
|
||||
### 🕒 Visual Timeline (New!)
|
||||
* **Git-Style Branching:** A dedicated tab visualizes your edit history as a **horizontal node graph**.
|
||||
* **Non-Destructive:** If you jump back to an old version and make changes, the system automatically **forks a new branch** so you never lose history.
|
||||
* **Visual Diff:** Inspect any past version and see a "Delta View" highlighting exactly what changed (e.g., `Seed: 100 -> 555`) compared to your current state.
|
||||
* **Interactive Mode (WIP):** A zoomed-out, interactive canvas to explore complex history trees.
|
||||
|
||||
---
|
||||
|
||||
@@ -32,8 +39,11 @@ This tool is designed to run as a lightweight container on Unraid.
|
||||
1. **Prepare a Folder:** Create a folder on your server (e.g., `/mnt/user/appdata/ai-manager/`) and place the following files inside:
|
||||
* `app.py`
|
||||
* `utils.py`
|
||||
* `history_tree.py` (New logic engine)
|
||||
* `tab_single.py`
|
||||
* `tab_batch.py`
|
||||
* `tab_timeline.py`
|
||||
* `tab_timeline_wip.py`
|
||||
2. **Add Container in Unraid:**
|
||||
* **Repository:** `python:3.12-slim`
|
||||
* **Network:** `Bridge`
|
||||
@@ -42,9 +52,9 @@ This tool is designed to run as a lightweight container on Unraid.
|
||||
* **App Location:** Container `/app` ↔ Host `/mnt/user/appdata/ai-manager/`
|
||||
* **Project Data:** Container `/mnt/user/` ↔ Host `/mnt/user/` (Your media/JSON location)
|
||||
4. **Post Arguments (Crucial):**
|
||||
Enable "Advanced View" and paste this into **Post Arguments**:
|
||||
Enable "Advanced View" and paste this command to install the required graph engines:
|
||||
```bash
|
||||
/bin/sh -c "pip install streamlit opencv-python-headless && cd /app && streamlit run app.py --server.headless true --server.port 8501"
|
||||
/bin/sh -c "apt-get update && apt-get install -y graphviz && pip install streamlit opencv-python-headless graphviz streamlit-agraph && cd /app && streamlit run app.py --server.headless true --server.port 8501"
|
||||
```
|
||||
|
||||
### 2. ComfyUI Setup (The Nodes)
|
||||
@@ -60,32 +70,38 @@ This tool is designed to run as a lightweight container on Unraid.
|
||||
### The Web Interface
|
||||
Navigate to your container's IP (e.g., `http://192.168.1.100:8501`).
|
||||
|
||||
* **Navigator:** Use the sidebar to browse folders and "Pin" favorites for quick access.
|
||||
* **Editing:** Select a JSON file. If it's a batch file, the app will auto-detect it and ask you to switch to the **Batch Tab**.
|
||||
* **Saving:**
|
||||
* **Update File:** Saves changes to disk.
|
||||
* **Snapshot:** Saves changes AND creates a history entry with a custom note.
|
||||
* **Custom Parameters:** Scroll to the bottom of the editor (Single or Batch) to find the "🔧 Custom Parameters" section. Type a Key (e.g., `strength`) and Value (e.g., `0.8`) and click "Add".
|
||||
* **Timeline:** Switch to the **Timeline Tab** to see your version history.
|
||||
* **Restore:** Select a node from the list or click on the graph (WIP tab) to view details. Click "Restore" to revert settings to that point.
|
||||
* **Branching:** If you restore an old node and click "Save/Snap", a new branch is created automatically.
|
||||
|
||||
### ComfyUI Workflow
|
||||
Search for "JSON" in ComfyUI to find the new nodes.
|
||||
|
||||
#### Standard Nodes (For Single Files)
|
||||
#### Standard Nodes
|
||||
| Node Name | Description |
|
||||
| :--- | :--- |
|
||||
| **JSON Loader (Standard/I2V)** | Outputs prompts, FLF, Seed, and paths for Image-to-Video workflows. |
|
||||
| **JSON Loader (VACE Full)** | Outputs everything above plus specific VACE integers (frames to skip, schedule, etc.). |
|
||||
| **JSON Loader (LoRAs Only)** | Outputs the 6 LoRA strings. Keeps your main graph clean. |
|
||||
| **JSON Loader (Standard/I2V)** | Outputs prompts, FLF, Seed, and paths for I2V. |
|
||||
| **JSON Loader (VACE Full)** | Outputs everything above plus VACE integers (frames to skip, schedule, etc.). |
|
||||
| **JSON Loader (LoRAs Only)** | Outputs the 6 LoRA strings. |
|
||||
|
||||
#### Batch Nodes (For Sequences)
|
||||
These nodes accept a `sequence_number` integer input.
|
||||
* **Input:** Connect a `Primitive` node (set to increment) or a `Batch Indexer` to the `sequence_number` input.
|
||||
* **Logic:** If you request Sequence #5 but the file only has 3 sequences, it wraps around (Sequence #2). This allows infinite loops.
|
||||
#### Universal Custom Nodes (New!)
|
||||
These nodes read *any* key you added in the "Custom Parameters" section. They work for both Single files (ignores sequence input) and Batch files (reads specific sequence).
|
||||
|
||||
| Node Name | Description |
|
||||
| :--- | :--- |
|
||||
| **JSON Loader (Custom 1)** | Reads 1 custom key. Input the key name (e.g., "strength"), outputs the value string. |
|
||||
| **JSON Loader (Custom 3)** | Reads 3 custom keys. |
|
||||
| **JSON Loader (Custom 6)** | Reads 6 custom keys. |
|
||||
|
||||
#### Batch Nodes
|
||||
These nodes require an integer input (Primitive or Batch Indexer) for `sequence_number`.
|
||||
|
||||
| Node Name | Description |
|
||||
| :--- | :--- |
|
||||
| **JSON Batch Loader (I2V)** | Loads specific sequence data for I2V. |
|
||||
| **JSON Batch Loader (VACE)** | Loads specific sequence data for VACE. |
|
||||
| **JSON Batch Loader (LoRAs)** | Loads the specific LoRAs assigned to that sequence. |
|
||||
| **JSON Batch Loader (LoRAs)** | Loads specific LoRAs for that sequence. |
|
||||
|
||||
---
|
||||
|
||||
@@ -93,8 +109,11 @@ These nodes accept a `sequence_number` integer input.
|
||||
|
||||
```text
|
||||
/ai-manager
|
||||
├── app.py # Main Streamlit entry point
|
||||
├── utils.py # Configuration, I/O logic, and Defaults
|
||||
├── tab_single.py # UI Logic for Single File Editor
|
||||
├── tab_batch.py # UI Logic for Batch Processor
|
||||
└── json_loader.py # ComfyUI Custom Node script
|
||||
├── app.py # Main entry point & Tab controller
|
||||
├── utils.py # I/O logic, Config, and Defaults
|
||||
├── history_tree.py # Graph logic, Branching engine, Graphviz generator
|
||||
├── tab_single.py # Single Editor UI
|
||||
├── tab_batch.py # Batch Processor UI
|
||||
├── tab_timeline.py # Stable Timeline UI (Compact Graphviz + Diff Inspector)
|
||||
├── tab_timeline_wip.py # Interactive Timeline UI (Streamlit Agraph)
|
||||
└── json_loader.py # ComfyUI Custom Node script
|
||||
|
||||
Reference in New Issue
Block a user