afk.ai Auto-Rig

io.github.dyoburonPublished by GitHub account dyoburonv1.3.5Updated Nov 5, 2026

Auto-rig 3D models (GLB, glTF, FBX) with skeleton, skin weights and 170+ animations via afk.ai.

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Auto-rigs 3D models (GLB, glTF, FBX) or turns a picture into a rigged, animated character via the afk.ai API, then inspects and fixes the rig locally.

What you can do
  • Rig models and create characters: auto-rig a 3D file or generate a rigged character from a picture, and list body types and their animations
  • Check account usage: see remaining free rigs, API credits and character credit balance, and look up the status of a rig by id
  • Inspect and render rigs: list bones, meshes, height and problem animations, and draw the model at rest or posed with its skeleton
  • Adjust and repair rigs: change animation controls, heal stretched or torn skin, and fix skin weights on a chosen spot, each writing a new file
When to use it
Useful when you have 3D characters or models that need a skeleton, skin weights and ready-made animations, or when an existing rigged model needs its animations adjusted and its skin tears or weight problems repaired before use in a game or animation pipeline.
Requirements
Runs as a local npm package over stdio on a desktop machine. An afk.ai API key is required in the AFK_API_KEY environment variable for the rigging and image-to-character tools; the local inspect, render, adjust and fix tools need no key. Network access to afk.ai is needed for rigging.
Before you install
Rigging consumes the account's free monthly rigs or API credits, and image_to_character costs $0.25 of credits that free rigs do not cover, so spending is involved. The API key is a secret sent to afk.ai, and uploaded models and pictures pass through afk.ai's content check. The adjust and fix tools write new .glb files next to the originals.

Installation

In SourceWeft

  1. Open afk.ai Auto-Rig in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Tools

10

rig_model

Auto-rig a 3D model file (.glb, .gltf with everything embedded, or .fbx; up to 200 MB) and write the rigged .glb with its animations. Takes about a minute. Returns where the file was written.

Parameterspathrequiredtypefacingoutputanimationskeep_arms_out

image_to_character

Make a rigged, animated 3D character from a picture (.png, .jpg or .webp of one character, whole; up to 20 MB): a 3D model made from the picture, rigged with every animation for its body type, written as a .glb. Takes about 2 to 3 minutes (up to 5 when the GPU is starting) and costs $0.25 of API credits, refunded if it fails. Returns where the file was written, what was charged and the credits left.

Parameterspathrequiredtypeoutputanimationskeep_arms_out

get_account

How many rigs the account can make (rigs_left: its free rigs this month, then its Lifetime API credit this month with afk.ai Lifetime, then its API credits), and its credit balance for characters.

Takes no parameters.

list_body_types

The body types a model can be rigged as, and (with type) that type's animations.

Parameterstype

rig_status

A rig's status by id (rig_model waits for its rig, so this is for rigs started elsewhere).

Parametersidrequired

inspect_rig

Measure a rigged .glb: its bones (names, parents, positions), meshes, height, the animations with problems, worst first, each with the moment it's worst at to render (ground: % of height its lowest point goes below the rest floor or stays above it, and which bone; stretching: % of skin torn at worst; humans: frames with a forearm or hand through the body, and the deepest) and the animation controls adjust_animation takes. Flying, swimming and other animations that leave the floor on purpose are marked in_the_air and not judged against it. Runs on this computer, free: about a second, a few for a human's 196 animations.

Parametersfilerequiredtypelimitanimations

render_rig

Draw a rigged .glb as an image to look at: at rest, or posed at a moment of one of its animations, with its skeleton over it (blue: its left, red: its right, orange: the middle) and rulers in model units. Pinkish-red skin is the inside of the mesh showing (a tear, or a part pushed through another). Also returns every joint drawn in the image with its pixel position and, posed, how far its lowest point is from the rest floor (lowest_point_vs_floor, % of height). Runs on this computer, free.

Parametersfilerequiredsizetimetypexrayfocusviewsjointsradiussave_toweightsanimation

adjust_animation

Change animations of a rigged .glb as afk.ai/rig's Adjust > Animation does, and write a new .glb: turn parts of the body (controls such as armsUp, posture, headUp in degrees), change how it moves (speed, motion, bounce, sway, lag, lookAhead, width, lift, part:arms...), move a hand, foot or the body (positions, the limb reaching for it), and for humans keep the arms out of the body. inspect_rig lists the controls this body type has, with their ranges. Reports each changed animation's ground [before, after] (and arms-through-body frames with keep_arms_out). Runs on this computer, free.

Parametersfilerequiredtypeoutputrangescontrolspositionsanimationskeep_arms_out

fix_stretching

Find where the skin of a rigged .glb stretches or tears across its animations and heal it (afk.ai/rig's Fix stretching), writing a new .glb. Reports torn skin [before, after] overall and per animation. Runs on this computer, free.

Parametersfilerequiredtypeoutputanimations

fix_spot

Fix the skin weights of one spot of a rigged .glb (afk.ai/rig's Fix a spot) and write a new .glb. Pick the spot with where (every given condition must hold), then: follow (it moves with the wrong part: give it to bone), smooth (pinched, jagged or creased: strength light, medium or strong) or redo (it tears or sticks to another part: its weights worked out again from the nearest bones). Reports the bones the spot follows [before, after]. Runs on this computer, free.

Parametersfixrequiredbonefilerequiredtypewhererequiredoutputstrength

Version history

2
  1. v1.3.5LatestNov 5, 2026
  2. v1.3.2Nov 3, 2026

Score

65% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.