Skip to content

FaceLink 0.3.6 Alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@xuebazhou-blip xuebazhou-blip released this 20 Aug 18:03
v0.3.6
56b5995

FaceLink 0.3.6 Alpha

FaceLink turns constrained shot descriptions into ordinary editable Blender animation while
keeping scene mutation behind typed validation and visible artist review.

Highlights

  • Editable movement, turning, camera tracking, Action/NLA playback and deterministic navigation.
  • Reviewed rename_only, sampled bake_pose and evaluated bake_evaluated_pose rig adapters.
  • Placement-preserving Armature object-motion baking with source-unit or rig-scaled translation.
  • Scene, Action and Rig fingerprints reject stale plans before mutation.
  • Blender-side Stage, Apply, Discard, revision history and safe current-session rollback.
  • MCP tools can use the model already available in the client; BYOK OpenAI planning remains
    optional and separately billed.

Verified

  • 88 Python tests.
  • 92.91% line coverage and 85.41% 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, clean install and installed
    extension loading on every tested Blender version.

Install

  1. Download facelink-0.3.6.zip and facelink-0.3.6-py3-none-any.whl below.

  2. In Blender 4.2 or newer, open Edit → Preferences → Get Extensions → Install from Disk,
    select the ZIP, enable FaceLink, open the FaceLink sidebar and press Start Bridge.

  3. Install Python 3.11 or newer, then install the wheel in an isolated environment:

    py -3.11 -m venv .venv
.\.venv\Scripts\python -m pip install .\facelink-0.3.6-py3-none-any.whl
.\.venv\Scripts\facelink-mcp

  4. Add that facelink-mcp executable to your MCP client's configuration. See the README for a
    complete example.

Verify downloaded files with SHA256SUMS.txt before installation.

Alpha boundaries

  • Windows is the only fully verified operating system in this release.
  • Mapping review is required; FaceLink does not universally infer controllers or convert IK/FK.
  • External driver/constraint dependencies and parented or constrained Armature object motion are
    rejected.
  • FaceLink does not generate missing character motion or judge artistic animation quality.
  • Paid/live OpenAI provider behavior is not part of the acceptance matrix.

Report reproducible defects through the issue form and use private vulnerability reporting for
security issues. Do not attach API keys, bearer tokens or unlicensed production assets.

Assets 6
Loading