https://github.com/AngelCookies/ComfyUI-Seed-Tracker
ComfyUI Seed Tracker Track, log, and manage random seeds across your entire ComfyUI workflow. This custom node extension helps you record seeds from specific nodes or batches, export in multiple formats, and maintain reproducibility in your AI image generation process.
https://github.com/AngelCookies/ComfyUI-Seed-Tracker
Last synced: 2 months ago
JSON representation
ComfyUI Seed Tracker Track, log, and manage random seeds across your entire ComfyUI workflow. This custom node extension helps you record seeds from specific nodes or batches, export in multiple formats, and maintain reproducibility in your AI image generation process.
- Host: GitHub
- URL: https://github.com/AngelCookies/ComfyUI-Seed-Tracker
- Owner: AngelCookies
- License: mit
- Created: 2025-04-20T16:49:59.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-21T19:53:49.000Z (2 months ago)
- Last Synced: 2025-04-21T20:29:37.484Z (2 months ago)
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **ComfyUI-Seed-Tracker**
README
# ComfyUI Seed Tracker
A custom node extension for ComfyUI that tracks and logs random seeds used throughout your image generation workflows.
## Features
- Track individual seeds from specific nodes
- Global seed tracking mode to monitor seeds in a workflow
- Export seed logs in different formats (JSON, CSV, TXT)
- Organize seeds by session ID for easy reference
- Add custom notes to tracked seeds
## Installation
### Using ComfyUI Manager
1. Open ComfyUI
2. Open ComfyUI Manager
3. Search for "Seed Tracker"
4. Click Install
### Manual Installation
1. Navigate to your ComfyUI custom_nodes directory:
```
cd ComfyUI/custom_nodes/
```
2. Clone this repository:
```
git clone https://github.com/angelcookies/comfyui-seed-tracker.git
```
Alternatively, download and extract the ZIP file to your custom_nodes directory.
3. Restart ComfyUI
## Usage
After installation, you'll find the following nodes in the "utils/seed_tracking" category:
### Seed Tracker Node
Connect this node to track seeds from individual nodes.
Inputs:
- `seed`: The seed value to track
- `node_id`: A unique identifier for the node (helps with organization)
- `notes`: Optional notes to add context to the tracked seed
Outputs:
- `seed`: The same seed passed through (for convenience in workflows)
- `log_path`: Path to the JSON log file
### Global Seed Tracker Node
A standalone node that creates a session log file and attempts to track seeds automatically.
Inputs:
- `enabled`: Toggle tracking on/off
- `include_metadata`: Include workflow metadata in logs
- `session_name`: Optional custom session name
Outputs:
- `log_path`: Path to the session log file
### Seed Exporter Node
Export tracked seeds in different formats.
Inputs:
- `session_id`: The session ID to export (leave empty for all sessions)
- `format`: Output format (json, csv, txt)
Outputs:
- `export_path`: Path to the exported file
## Log Files
All seed logs are stored in your ComfyUI output directory under a `seed_logs` folder. Each session creates a unique log file with timestamp-based naming.
## Example Workflow
1. Add a "Global Seed Tracker" node at the beginning of your workflow
2. Connect "Seed Tracker" nodes to any KSampler or other nodes where you want to track specific seeds
3. When you want to reference seeds later, use the "Seed Exporter" node to export them in your preferred format
## Advanced Integration
For advanced users who want to automatically track all seeds without manually connecting nodes, you can modify the ComfyUI server code to hook into the execution system. This requires deeper integration with the ComfyUI API and is beyond the scope of this basic extension.
## Future Features
- Automatic seed detection without manual node connections
- Web UI for browsing and searching captured seeds
- Integration with prompt history
- Thumbnail generation for associated images
## Credits
- Development assisted by Claude AI from Anthropic
- Special thanks to the ComfyUI community
## License
MIT License