Skip to content

FaceLink 0.3.7 Alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@xuebazhou-blip xuebazhou-blip released this 20 Aug 18:23
· 11 commits to main since this release
v0.3.7
86bb1d8

FaceLink 0.3.7 Alpha

FaceLink 0.3.7 turns the existing creator-review engine into a more installable Windows alpha.
Blender remains an external dependency: the release detects Blender 4.2 or newer but does not
redistribute the several-hundred-megabyte application.

Highlights

  • facelink doctor diagnoses Python, the installed FaceLink host, MCP launcher, Blender version,
    discovery directory, live authenticated bridge and optional OpenAI BYOK readiness.
  • Human-readable output supports setup; stable JSON output supports bug reports and automation.
  • Diagnostic output contains neither OPENAI_API_KEY values nor bridge bearer tokens.
  • install-windows.ps1 verifies release checksums and provides a fully non-mutating -PlanOnly
    mode before it creates an isolated host or installs the Blender extension.
  • The Blender bridge health response reports the FaceLink version for version-skew diagnosis.

Install

  1. Install official Blender 4.2 or newer and Python 3.11 or newer.

  2. Download install-windows.ps1, facelink-0.3.7.zip,
    facelink-0.3.7-py3-none-any.whl and SHA256SUMS.txt from this release.

  3. Run the checksum-verifying installer:

    .\install-windows.ps1 `
  -WheelPath .\facelink-0.3.7-py3-none-any.whl `
  -ExtensionZipPath .\facelink-0.3.7.zip `
  -ChecksumsPath .\SHA256SUMS.txt

  4. Open Blender's FaceLink sidebar and press Start Bridge.

  5. Run the installed facelink doctor --blender-exe C:\path\to\blender.exe, then configure the
    printed facelink-mcp.exe path in the MCP client.

Use -PlanOnly first to inspect paths without changing the machine. If FaceLink is already
installed in Blender, update or remove that extension through Blender Preferences before the
automatic extension step.

Verified

  • 101 Python unit, CLI, MCP and diagnostics tests.
  • 93.39% line coverage and 86.05% branch coverage.
  • Blender 4.2.23 LTS, 4.5.12 LTS and 5.2.0 LTS on Windows x64.
  • Source execution, overlay UI, authenticated bridge, ZIP validation and isolated extension
    installation on every tested Blender version.
  • Windows installer plan, release checksum verification and clean wheel installation.

Alpha boundaries

  • Windows is the only fully verified operating system in this release.
  • Blender and Python are prerequisites rather than bundled applications.
  • Mapping review is required; FaceLink does not universally infer controllers or convert IK/FK.
  • FaceLink does not generate missing character motion or judge artistic animation quality.
  • Paid/live OpenAI provider behavior is not part of the acceptance matrix.
Assets 7
Loading