mthds-runner-setup

Configure inference backends and API keys for MTHDS methods.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/mthds-ai/mthds-plugins --skill mthds-runner-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mthds-runner-setup
Source: https://github.com/mthds-ai/mthds-plugins/tree/main/mthds-codex/skills/mthds-runner-setup
Command: npx skills add https://github.com/mthds-ai/mthds-plugins --skill mthds-runner-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many MTHDS methods cannot run until inference backends and API keys are configured; this Skill guides users through initial setup, reconfiguration, and recovery from credential or config errors so methods can execute live model inference.

Core Features & Use Cases

  • Environment and version validation: Checks mthds-agent presence and version and handles outdated or missing toolchain scenarios.
  • Interactive choice flow: Presents Pipelex Gateway (recommended) or Bring Your Own Key (BYOK) options and follows the selected path.
  • Pipelex Gateway onboarding: Records terms acceptance, opens login to obtain an API key, initializes gateway backends, and verifies health with mthds-agent doctor.
  • BYOK setup: Guides adding provider keys to ~/.pipelex/.env, initializes specified backends, requires primary_backend when multiple non-gateway backends are selected, and runs verification.
  • Recovery and verification: Offers upgrade guidance, surfaces CLI errors, and instructs users how to re-run the original method after success.

Quick Start

Choose Pipelex Gateway or BYOK when prompted, run mthds login to obtain a Pipelex API key if using the gateway, then run mthds-agent init -g with your chosen backends and mthds-agent doctor to verify the configuration.

Frequently Asked Questions about mthds-runner-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix InferenceSetupRequiredError when running MTHDS methods?▼

Resolve InferenceSetupRequiredError by running mthds-agent init with your chosen backend, then verify the configuration using mthds-agent doctor to enable live model execution.

What is the difference between Pipelex Gateway and BYOK for inference setup?▼

Pipelex Gateway is the recommended path requiring terms acceptance and mthds login to obtain an API key, while Bring Your Own Key (BYOK) requires adding provider keys directly to the ~/.pipelex/.env file.

How do I configure multiple BYOK backends for live model inference?▼

To configure multiple BYOK backends, add your provider keys to ~/.pipelex/.env, then run mthds-agent init specifying a primary_backend since one is required when multiple non-gateway backends are selected.

Do I need mthds-agent installed before setting up API keys?▼

Yes, mthds-agent must be installed because the setup performs environment and version validation, checks for the toolchain's presence, and handles outdated scenarios before configuring inference backends.

Why is my mthds-agent doctor verification failing after initial setup?▼

Verification may fail due to outdated mthds-agent versions, missing credentials in ~/.pipelex/.env, or gateway health issues, so upgrade the toolchain, verify keys, and re-run mthds-agent doctor.