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.