digital-garbage
2739203992
Use fixed-height images so Ko-Fi, Patreon, and Vast.ai badges line up cleanly on GitHub.
103 lines
4.7 KiB
Markdown
103 lines
4.7 KiB
Markdown
# ComfyUI-FunPack
|
|
|
|
A set of ComfyUI nodes for experimenting with video generation workflows based on WAN, HunyuanVideo, LTX, and similar models.
|
|
|
|
<p align="left">
|
|
<a href="https://ko-fi.com/M4M61MBGIT"><img src="https://ko-fi.com/img/githubbutton_sm.svg" alt="Ko-fi" height="36"></a>
|
|
<a href="https://patreon.com/digitalgarbage?utm_medium=unknown&utm_source=join_link&utm_campaign=creatorshare_creator&utm_content=copyLink"><img src="https://c5.patreon.com/external/logo/become_a_patron_button.png" alt="Patreon" height="36"></a>
|
|
<a href="https://cloud.vast.ai/?ref_id=308176"><img src="https://img.shields.io/badge/Run%20on-Vast.ai-BCFF41?style=for-the-badge&logoColor=000000" alt="Vast.ai" height="36"></a>
|
|
</p>
|
|
|
|
## Dev Branch
|
|
|
|
The `dev` branch is intended for testing unfinished changes, implementing new logic and basically, flipping everything just because I can. It can be broken, renamed, or changed without warning.
|
|
|
|
Use only `main` if you want the most stable version of this node pack. Bug reports based on `dev` version will be ignored.
|
|
|
|
## Installation
|
|
|
|
FunPack is available on Comfy Registry and can be installed in any of these ways:
|
|
|
|
1. With `comfy-cli`:
|
|
`comfy node install ComfyUI-FunPack`
|
|
2. With git, inside your `ComfyUI/custom_nodes` directory:
|
|
`git clone https://github.com/digital-garbage/ComfyUI-FunPack`
|
|
3. With ComfyUI-Manager:
|
|
Open `Custom Nodes Manager`, search for `ComfyUI-FunPack`, and click `Install`.
|
|
|
|
## Dependencies
|
|
|
|
FunPack includes a [`requirements.txt`](requirements.txt) file for its Python dependencies.
|
|
|
|
Install them with:
|
|
|
|
`pip install -r requirements.txt`
|
|
|
|
FunPack uses your existing ComfyUI/PyTorch install. The expected baseline is `transformers >= 5.0.0`
|
|
|
|
`hpsv3` is optional and only used by the `FunPack StoryMem Keyframe Extractor` quality filter, so it is not installed by default.
|
|
|
|
Install it manually only if you need that feature:
|
|
|
|
`pip3 install hpsv3 --no-build-isolation`
|
|
|
|
## Important Note About `hpsv3`
|
|
|
|
Installing `hpsv3` can break `Prompt Enhancer` and `Story Writer`, because `hpsv3` depends on a `transformers` version that conflicts with the version those LLM-based nodes require.
|
|
|
|
FunPack's LLM nodes require `transformers >= 5.0`. The version required for `hpsv3` is strictly `transformers==4.45.2`. Installing any version different from it will result in broken quality detector.
|
|
|
|
If you install `hpsv3`, use `--no-build-isolation`. Optionally, specify the exact version - `pip install transformers==4.45.2 --no-build-isolation`.
|
|
|
|
## Documentation
|
|
|
|
Per-node documentation is available in the [`docs`](docs) folder.
|
|
|
|
Start with:
|
|
|
|
- [`docs/FunPackVideoRefinerV2.md`](docs/FunPackVideoRefinerV2.md) for `FunPack Video Refiner V2`
|
|
- [`docs/FunPackVideoRefinerV2QuickGuide.md`](docs/FunPackVideoRefinerV2QuickGuide.md) for a short Discord-friendly Refiner V2 guide
|
|
- [`docs/FunPackLTXAVSceneChainSampler.md`](docs/FunPackLTXAVSceneChainSampler.md) for split-scene LTXV/LTXAV continuation
|
|
- [`docs/FunPackLoraWorkflow.md`](docs/FunPackLoraWorkflow.md) for the LoRA/refiner helper workflow
|
|
- [`docs/FunPackSceneBuilder.md`](docs/FunPackSceneBuilder.md) for scene preset workflows
|
|
|
|
Version history is available in [CHANGELOG.md](CHANGELOG.md).
|
|
|
|
## Feedback
|
|
|
|
If you have suggestions, questions, or ideas for new nodes, feel free to open an issue or submit a pull request.
|
|
|
|
## Intent
|
|
|
|
FunPack is a hobby project, provided to you by a fellow AI enthusiast who "lives in the trenches" and knows exactly what people seek in video/audio generation workflows.
|
|
|
|
FunPack is provided under GNU General Public License V3, which gives you broad rights to use, modify and distribute the original/modified version of it as long as the original license text is included. FunPack places no limitations on types of content you can generate by using it, meaning both SFW and NSFW content are fine as long as you don't violate your local laws. GPLv3 does not grant you rights for such violations.
|
|
|
|
However, I do not endorse using FunPack and/or demonstrating it alongside morally and legally questionable/prohibited content, including:
|
|
- Non-consensual explicit depiction of a real person;
|
|
- Explicit depiction of minors;
|
|
- Depiction of violence and gore targeted at a real person.
|
|
|
|
I do not provide support to users who use FunPack in such cases, and in case I detect it, any support will be immediately ceased.
|
|
|
|
Thanks for understanding.
|
|
|
|
## Thank you
|
|
|
|
I express my deepest gratitude to:
|
|
|
|
- OpenAI and ChatGPT Codex;
|
|
- xAI and Grok Build;
|
|
- Anthropic and Claude Code;
|
|
- Team Cursor and Composer model;
|
|
- DeepSeek team and model;
|
|
- Google and Gemini;
|
|
- Lightricks and LTX-Video model;
|
|
- ComfyUI and its whole community.
|
|
|
|
Without all of you, this project would've been impossible.
|
|
|
|
With <3
|
|
|
|
DigitalGarbage
|