Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HF_HOMENoOptional shared Hugging Face cache and local authentication directory.
KIMODO_REPOYesAbsolute path to the reviewed upstream checkout.
KIMODO_PYTHONYesAbsolute path to Python with Kimodo and inference dependencies.
KIMODO_DATA_DIRYesShared jobs, reports, exports, and registrations outside this repository.
KIMODO_JOB_TIMEOUTNoWaiting and execution limits, applied separately; default `3600` seconds.3600
KIMODO_WORKER_MODENo`service` is the independent worker; optional `child` mode follows the client process tree.
TEXT_ENCODER_DEVICENo`cpu` reduces GPU use by moving the encoder into system memory.
KIMODO_CHARACTER_FBXNoOptional source for the supported fitted-character profile.
KIMODO_UNREAL_ENGINENoOptional Unreal installation root containing `Engine`.
KIMODO_ALLOW_DOWNLOADSNo`1` permits first-run downloads; ordinary worker startup is offline.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_capabilitiesA

Discover every registered operation, workflow, input schema, model and implementation boundary.

get_workflowA

Get an ordered workflow recipe, required inputs, completion evidence and recovery guidance; run nothing.

get_input_schemaB

Read a complete JSON input schema, including advanced generation and constraint controls.

list_modelsA

List exact supported model IDs, skeletons, export formats and upstream revision.

health_checkA

Check connection/storage; optionally probe the configured Python runtime without downloads.

get_workspace_stateB

Read shared worker/memory/editor status, character, saved Unreal target and recent job history.

Editor reachability checks only local TCP listeners. This does not start services, load models, verify an open project, or claim that the configured machine has sufficient inference capacity.

get_unreal_targetB

Read the same locally saved Unreal project, skeleton, mesh and destination used by the studio.

save_unreal_targetB

Save explicit Unreal target fields for this workspace; this does not open a project or import assets.

list_job_outputsB

List verified native, skeleton and fitted-character files with checksums, paths and sample/attempt identity.

build_character_previewB

Prepare, execute and verify a registered character preview through the same workflow as the studio.

Reuses a valid completed preview or chooses an unused attempt under a shared lock. Uncertain editor dispatch blocks automatic retries. Requires the supported registered source and Blender.

validate_motionB

Validate text segments, model compatibility, frame ranges and kinematic constraints offline.

generate_motionB

Queue motion generation and return a job ID immediately. May download weights if operator enabled it.

plan_animationA

Turn a natural action description and optional timed beats into an explicit generation plan.

Choose draft, balanced or detailed effort. Defaults: four seconds, one candidate, seed zero, current SOMA model, native postprocessing, NPZ and standard-T-pose BVH. No generation is started.

generate_animationC

Generate from a plain-language brief with transparent presets; return a durable job immediately.

revise_animationA

Plan or submit a new version while preserving every setting not explicitly changed.

The assistant supplies the rewritten action, not a vague editing instruction. Timing edits never silently retime existing constraints. The original job and outputs remain unchanged.

get_jobB

Get durable status, current stage, request, and final export manifest.

list_jobsB

List recent jobs shared by clients configured with the same data directory.

cancel_jobB

Request cancellation of a queued or running job; completed outputs remain available.

get_job_logB

Read a bounded tail of generation diagnostics with Hugging Face tokens redacted.

get_artifactA

Resolve and verify an exported file by its exact manifest path, including checksum and local URI.

inspect_motionB

Measure a completed NPZ: timing, skeleton, root travel, bounds and finite-value checks.

preview_motionC

Create an offline HTML animation viewer with playback, scrubber and camera controls.

export_motionA

Convert a completed native NPZ into SOMA BVH, SMPL-X AMASS, or G1 MuJoCo CSV without generation.

Requires the configured Kimodo runtime; runs offline on CPU without model weights. Only the source model's formats are accepted. Changed options must apply to the selected format. The original job stays unchanged; matching verified exports are reused. An incomplete attempt blocks automatic retries. Pass the returned export_id to prepare_blender_handoff for derived BVH.

inspect_motion_framesA

Read selected source frames as exact joint positions, hierarchy, timing and optional rotation matrices.

Uses checksum-verified completed motion, not rendered pixels or invented poses. Select up to 16 ordered frames and optionally named joints. Missing metadata remains explicitly unavailable.

extract_motion_constraintsA

Map several actual SOMA poses to destination frames as one reusable full-body or limb constraint.

Both frame lists must be ordered, unique and equally sized. World root coordinates are retained. Add the returned constraint to a new request, then validate its duration and all constraint conflicts. This reads poses; it does not smooth, resample or splice clips or guarantee seamless transitions.

extract_pose_constraintB

Reuse an actual SOMA pose as a constraint for a new generation, preserving its world position.

Returns a constraint to add to GenerateRequest.constraints. Validate the full new request; pose anchoring does not guarantee terminal-joint twists, velocity continuity or a seamless loop.

analyze_motion_qualityA

Measure speed, jerk, bone drift, contact sliding, floor proxies and endpoint seams.

These are review diagnostics, not a realism score or automatic repair. Original motion is unchanged.

create_motion_reviewB

Create an offline three-view player, exact-frame contact sheet and numerical diagnostic file.

Highlights uniform timeline samples and metric extrema with fixed whole-clip camera bounds.

compare_motionsA

Compare two completed motion samples with synchronized exact-frame views and measured differences.

Requires matching FPS and skeletons. B frame = A frame + offset. Root-relative removes translation only. Differences do not rank realism or prompt adherence; inspect both candidates before choosing.

get_character_profileA

Inspect the operator-configured fitted-character profile without loading Blender.

prepare_character_handoffB

Prepare Blender rigging, skinning and motion retargeting for the configured character.

Uses the inspected source's exact checksum. Saves a separate rigged mesh, animation FBX, .blend, and verification report. Execute the returned script through Blender MCP.

prepare_blender_handoffA

Prepare a trusted Blender script to import a generated SOMA BVH and save .blend/FBX.

Omit export_id to use the original manifest BVH, or select the exact ID returned by export_motion to use a verified derived BVH. Use a new attempt when changing the source. No editor action runs.

execute_blender_handoffB

Run only the prepared fixed script in the connected local Blender and verify its exports.

A completed receipt is reused. After an uncertain dispatch inspect the receipt before a new attempt. Character handoffs include an animated GLB for the local studio viewer.

get_handoff_reportC

Read the Blender execution report for a managed skeleton or fitted-character handoff.

prepare_unreal_handoffA

Prepare animation-only Unreal import after Blender reports a verified FBX export.

The editor checks the exact project and matching rig hierarchy before creating an asset. Import the rigged character mesh first, then use execute_unreal_handoff.

execute_unreal_handoffA

Import a prepared animation into its exact open Unreal project and verify the saved asset.

Requires the operator's engine registration and loopback Python remote execution. Executes only the bundled handoff script. A completed matching receipt is reused.

get_unreal_reportB

Read a managed Unreal import's final timing, rig and asset-path verification report.

Prompts

Interactive templates invoked by user choice

NameDescription
animation_workflowPlan, validate, generate, inspect and export an animation from a creative brief.

Resources

Contextual data attached and managed by the client

NameDescription
Supported Kimodo modelsExact model identifiers, skeletons, native formats and reviewed upstream revision.
Generation request schemaComplete structured generation contract, including advanced controls and constraints.
Agent capability catalogLive tool registry, workflows, schema index, limits, requirements and unsupported operations.
Local animation workspaceShared runtime/worker readiness, character, saved Unreal target and recent jobs.

TDQS

B3.2/5.0

Scored across 37 tools

Disambiguation3/5

Most tools target distinct lifecycle stages, but several boundaries are subtle: generate_motion vs generate_animation, plan_animation vs revise_animation, and inspect_motion vs inspect_motion_frames vs analyze_motion_quality vs create_motion_review. Detailed descriptions help, but an agent could still misselect among these overlapping motion-generation and inspection tools.

Naming Consistency5/5

Tool names consistently use snake_case and mostly follow a clear verb_noun pattern such as list_models, generate_motion, inspect_motion, prepare_blender_handoff, and execute_unreal_handoff. Minor exceptions like health_check are readable and do not disrupt the overall convention.

Tool Count2/5

With 37 tools, the server is heavy for an agent-facing surface and exceeds the typical well-scoped range. The domain is complex, but multiple generation, inspection, review, export, and handoff variants make the set difficult to navigate as a whole.

Completeness4/5

The surface covers a broad lifecycle: planning, validation, generation, job management, inspection, export, review, comparison, character prep, and Blender/Unreal handoffs. Minor gaps exist around cleanup/deletion and broader character management, but core workflows are well covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues