hotplex-setup

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.