{"id":42481686,"url":"https://github.com/room3dev/ComfyUI-I2VChainHelper","last_synced_at":"2026-02-07T20:00:35.756Z","repository":{"id":334083725,"uuid":"1139948351","full_name":"room3dev/ComfyUI-I2VChainHelper","owner":"room3dev","description":"ComfyUI custom node to filter and trim image batches based on face similarity and eye openness for I2V chaining.","archived":false,"fork":false,"pushed_at":"2026-01-22T18:25:08.000Z","size":1981,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-23T10:35:35.927Z","etag":null,"topics":["comfyui","custom-nodes","dlib","face-analysis","i2v","image-to-video","insightface","video-generation"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/room3dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-22T16:19:07.000Z","updated_at":"2026-01-22T18:25:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/room3dev/ComfyUI-I2VChainHelper","commit_stats":null,"previous_names":["room3dev/comfyui-i2vchainhelper"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/room3dev/ComfyUI-I2VChainHelper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/room3dev%2FComfyUI-I2VChainHelper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/room3dev%2FComfyUI-I2VChainHelper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/room3dev%2FComfyUI-I2VChainHelper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/room3dev%2FComfyUI-I2VChainHelper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/room3dev","download_url":"https://codeload.github.com/room3dev/ComfyUI-I2VChainHelper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/room3dev%2FComfyUI-I2VChainHelper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29206797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-07T17:44:10.191Z","status":"ssl_error","status_checked_at":"2026-02-07T17:44:07.936Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["comfyui","custom-nodes","dlib","face-analysis","i2v","image-to-video","insightface","video-generation"],"created_at":"2026-01-28T11:00:24.072Z","updated_at":"2026-02-07T20:00:35.750Z","avatar_url":"https://github.com/room3dev.png","language":"Python","funding_links":[],"categories":["Workflows created in 7 days"],"sub_categories":[],"readme":"# ComfyUI-I2VChainHelper\n\nA ComfyUI custom node designed to help filter and trim image batches for consistent Image-to-Video (I2V) chaining.\n\n![Workflow Diagram](assets/workflow_diagram.png)\n\n## Problem Statement\nWhen chaining video generations (using the last frame of one video to start another), the quality and identity consistency of the last frame is critical. If the last frame has a motion-blurred face, closed eyes, or loses the subject's identity, the next generation will likely drift away from the original person.\n\n## Solution\n`I2VChainHelper` analyzes an image batch (the output of a previous generation) and trims it to the last frame that satisfies specific criteria:\n1. **Face Similarity**: Ensures the person in the frame still matches the reference person (the first frame of the batch).\n2. **Eye Openness**: Ensures the eyes are sufficiently open (using Eye Aspect Ratio - EAR), which is important for starting clear video generations.\n\n## Installation\n\n1. Copy this folder to your ComfyUI `custom_nodes` directory.\n2. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n3. Ensure you have `ComfyUI-FaceAnalysis` or a compatible model loader to provide the `ANALYSIS_MODELS` input.\n\n## Nodes\n![Node Screenshot](assets/screenshot.png)\n\n### I2V Chain Helper\n- **Inputs**:\n    - `images`: Image batch.\n    - `analysis_models`: Face analysis models (InsightFace or DLib).\n    - `min_face_similarity`: Minimum cosine similarity to the reference face (default: 0.5).\n    - `min_eyes_openness`: Minimum EAR score for open eyes (default: 0.4).\n    - `reference_image` (optional): If provided, use this image as the identity reference instead of the first frame of the batch.\n- **Outputs**:\n    - `trimmed_images`: The filtered and potentially shortened batch.\n    - `frame_count`: Number of images in the trimmed batch.\n    - `first_frame`: The first image of the trimmed batch (for convenience).\n    - `last_frame`: The last \"good\" image of the trimmed batch (useful for I2V chaining).\n    - `face_similarity`: The face similarity score of the last good frame (0..1).\n    - `eyes_openness`: The eye openness (EAR score) of the last good frame.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froom3dev%2FComfyUI-I2VChainHelper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froom3dev%2FComfyUI-I2VChainHelper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froom3dev%2FComfyUI-I2VChainHelper/lists"}