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.