hotplex-setup

Diagnose HotPlex setup failures from doctor JSON reports and apply category-based fixes.

47|15|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/hrygo/hotplex --skill hotplex-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hotplex-setup
Source: https://github.com/hrygo/hotplex/tree/main/.agents/skills/hotplex-setup
Command: npx skills add https://github.com/hrygo/hotplex --skill hotplex-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves HotPlex installation, environment validation, configuration issues, and startup failures by guiding you through doctor-driven diagnosis and category-based fixes, including STT/TTS and Agent personalization needs.

Core Features & Use Cases

  • Doctor-driven environment checks: Runs HotPlex doctor in JSON mode, interprets pass/warn/fail summaries, and directs next actions without you manually checking every dependency.
  • End-to-end setup & onboarding: Guides first-time installation via hotplex onboard (interactive or non-interactive) and verifies with doctor, config validation, and service health checks.
  • Targeted troubleshooting by failure category: Provides actionable remediation for environment, configuration, dependencies (Go/Python/ffmpeg/STT/TTS), security (tokens/permissions), runtime (ports/data dirs/PIDs), messaging platforms (Slack/Feishu), and agent_config issues.
  • Cross-platform guidance: Covers Linux/macOS/Windows installation differences, service managers (systemd/launchd/SCM), and common OS-specific pitfalls.

Quick Start

Tell the assistant: run hotplex-setup to diagnose my HotPlex on this machine, then guide me through fixing any doctor failures and finishing with a verification step.

Frequently Asked Questions about hotplex-setup

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

FAQPage Schema
How do I troubleshoot HotPlex installation failures?

Run hotplex doctor --json to parse diagnostic summaries and route fixes by category for installation, configuration, dependencies, security, runtime, messaging, STT/TTS, and agent customization failures.

How do I fix HotPlex port conflicts and service startup issues?

Fix HotPlex port conflicts and service startup issues by running doctor diagnostics to identify runtime failures, then applying platform-aware commands for your specific service manager before re-verifying.

Can I use HotPlex with Slack and Feishu on different operating systems?

Yes, HotPlex supports Slack and Feishu messaging platforms across Linux, macOS, and Windows, providing cross-platform guidance for service managers like systemd, launchd, and SCM to resolve token validation problems.

Why does my HotPlex setup report missing Go, Python, or ffmpeg dependencies?

Your HotPlex setup reports missing Go, Python, or ffmpeg dependencies because the environment lacks required components, which the doctor JSON report identifies so you can perform targeted remediation for each missing dependency.

How do I resolve misconfigured STT and TTS models or providers in HotPlex?

Resolve misconfigured STT and TTS models or providers by running hotplex doctor to detect the configuration failures, applying the suggested fixes for your specific speech-to-text and text-to-speech components, and re-running diagnostics.

What is the best way to validate a HotPlex environment after an upgrade?

The best way to validate a HotPlex environment after an upgrade is to run hotplex doctor to check configurations and dependencies, applying category-based fixes iteratively until the summary fail count equals zero.