Skip to content

v2.1.3: unicode-safe AI model I/O, site link, video tutorial#186

Merged
edenaion merged 7 commits into
mainfrom
fix/unicode-ai-modules
Jul 9, 2026
Merged

v2.1.3: unicode-safe AI model I/O, site link, video tutorial#186
edenaion merged 7 commits into
mainfrom
fix/unicode-ai-modules

Conversation

@edenaion

@edenaion edenaion commented Jul 9, 2026

Copy link
Copy Markdown
Owner

Fixes #184.

Fix: AI methods fail on non-ASCII Windows paths (#184)

All AI alpha-hint methods (GVM Auto, BiRefNet variants, Dynamic Matting, VideoMaMa) failed for users whose Windows username contains non-ASCII characters. The #167 facade fix covered backend/ and ui/ only; the vendored model modules kept raw cv2 file calls, which use a narrow ANSI file API on Windows and silently fail on such paths. Extraction and chroma key already used the facade, which is why only the AI paths broke for the reporter.

☼ Route all raw cv2.imread/imwrite/VideoCapture in gvm_core, BiRefNetModule, MatAnyone2Module, and VideoMaMaInferenceModule through the backend.frame_io facade
☼ Add an open_video_writer facade: plain writer, then parent-dir 8.3 short-path alias, then ASCII temp staging moved into place on release()
☼ Extend the AST guard test to scan all model module directories so this cannot regress
☼ Add non-ASCII regression tests: GVM ImageSequenceReader, MatAnyone2 frame reader, and video writer round-trips across accented Latin, Cyrillic, and CJK paths

Verified: raw cv2.imread returns None on an existing EXR under an accented directory while the facade reads it; full suite 723 passed.

Docs

☼ Website badge and official-site line pointing at https://ezcorridorkey.com (main README + all 16 translations), supersedes #185
☼ Creator's step-by-step YouTube tutorial linked at the top of the Installation section as a clickable thumbnail, with localized captions in all 16 translations

edenaion added 3 commits July 9, 2026 14:03
All AI alpha-hint methods (GVM Auto, BiRefNet variants, Dynamic Matting,
VideoMaMa) failed for users whose Windows username contains non-ASCII
characters. The #167 facade fix covered backend/ and ui/ only; the vendored
model modules kept raw cv2 file calls, which use a narrow ANSI file API on
Windows and silently fail on such paths. Extraction and chroma key already
used the facade, which is why only the AI paths broke.

☼ Route raw cv2.imread/imwrite/VideoCapture in gvm_core, BiRefNetModule,
  MatAnyone2Module, and VideoMaMaInferenceModule through backend.frame_io
☼ Add open_video_writer facade: plain writer, then parent-dir 8.3 alias,
  then ASCII temp staging moved into place on release()
☼ Extend the AST guard to scan all model module directories
☼ Add non-ASCII regression tests: GVM ImageSequenceReader, MatAnyone2
  frame reader, and video writer round-trips across scripts
☼ Add a Website badge to the main README and all 16 translations, next to the EZSCAPE badge, linking https://ezcorridorkey.com
☼ Add an "Official site" line under the intro so the repo points its authority at the domain
☼ Add the creator's step-by-step YouTube tutorial at the top of the
  Installation section as a clickable thumbnail
☼ Localized caption in the main README and all 16 translations
edenaion added 4 commits July 9, 2026 14:33
☼ check_ffmpeg.py still loaded the pre-refactor backend/ffmpeg_tools.py
  single file; point it at the ffmpeg_tools/discovery.py submodule
  (stdlib-only, still loads standalone), unbreaking the FFmpeg
  verification step in 1-install for every platform
☼ 3-update.sh: repair a main branch that has no upstream before pulling,
  instead of aborting with 'no tracking information'
☼ Skip the MatAnyone2 unicode test when omegaconf is absent (CI installs
  test deps only, not the model stack)
☼ Shallow PR checkouts sever ancestry between the merge ref and
  origin/main, so the updater's git pull aborted with 'divergent
  branches'; fetch-depth 0 restores the ancestry
☼ Stop swallowing set-upstream errors in the branch setup step
☼ 3-update.bat: repair a main branch with no upstream before pulling,
  matching the Unix updater; a bare git pull otherwise aborts with
  'no tracking information'
☼ 1-install.bat: drop the origin/master fallback when linking an install
  to git; origin/master froze at v1.5.2 and the fallback could silently
  link a fresh install to code 400+ commits behind
☼ %errorlevel% inside the parenthesized block expanded at parse time, so
  a failed git pull always printed '[OK] Code updated via git' and the
  script exited 0; use delayed expansion
☼ Match the Unix updater: keep running the dependency and weights steps,
  then report 'Update INCOMPLETE' and exit 1 when the pull failed
@edenaion edenaion merged commit e1a6d47 into main Jul 9, 2026
5 checks passed
@edenaion edenaion deleted the fix/unicode-ai-modules branch July 10, 2026 15:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

EZ-CorridorKey 2.1.2 - Clip remains RAW after Generate, inference cannot start (RTX 5080)

1 participant