How hypostasis-cat/hypomux works
HypoMux is a Windows desktop tool for distributing independent network connections across multiple adapters, with system-proxy and virtual-interface modes. Users select adapters, check link health, configure routing and scheduling, then start aggregation and monitor throughput; the desktop service layer coordinates the separate engine and privileged network operations. The README also documents AI assistance, hotspot and network diagnostics, Steam CDN optimization, rule subscriptions, updates, and appearance customization. Several internal links below follow explicit README descriptions or SOURCE INDEX references; unsampled feature implementations are represented at their supported directory paths.
Main entry points: App.tsx React application · services.ts Service bridge · server.go Engine API · EngineHero.tsx Aggregation controls
Components 24
Desktop experience
- React application
desktop/frontend/src/App.tsx - Aggregation controls
desktop/frontend/src/components/home/EngineHero.tsx - Engine state
desktop/frontend/src/state/useEngineState.ts - Routing rules
desktop/frontend/src/pages/RoutingPage.tsx - Connections view
desktop/frontend/src/pages/ConnectionsPage.tsx - Network health
desktop/frontend/src/pages/HealthPage.tsx - Settings
desktop/frontend/src/pages/SettingsPage.tsx - Appearance
desktop/frontend/src/theme/appearance.store.tsx
Desktop services
- Service bridge
desktop/frontend/src/platform/services.ts - Desktop host
desktop/main.go - Engine service
desktop/internal/services/engine.go - Engine client
desktop/internal/engineclient/client.go
Network engine
- Engine process
engine/cmd/hypomux-engine/main.go - Engine API
engine/internal/server/server.go - Proxy and scheduler
engine/internal/proxy/server.go
Network operations
- TUN lifecycle
engine/internal/tun/supervisor.go - Network services
desktop/internal/services
Product capabilities
- AI assistant
desktop/internal/services/ai_service.go - Aggregated hotspot
desktop/internal/services/hotspot.go - Steam CDN
desktop/internal/services/steam_cdn.go - Rule subscriptions
desktop/internal/services/rule_sets_service.go - Update service
desktop/internal/services/updater.go
Other components
- User
- Network destinations
Connections 27
- User → React application: uses
README.md - React application → Aggregation controls: renders
desktop/frontend/src/App.tsx - React application → Routing rules: routes to
desktop/frontend/src/App.tsx - React application → Connections view: routes to
desktop/frontend/src/App.tsx - React application → Network health: routes to
desktop/frontend/src/App.tsx - React application → Settings: routes to
desktop/frontend/src/App.tsx - React application → Appearance: provides theme
desktop/frontend/src/App.tsx - Aggregation controls → Engine state: controls
desktop/frontend/src/components/home/EngineHero.tsx - Engine state → Service bridge: calls
desktop/frontend/src/state/useEngineState.ts - Routing rules → Service bridge: calls
desktop/frontend/src/pages/RoutingPage.tsx - Settings → Service bridge: calls
desktop/frontend/src/platform/services.ts - Network health → Service bridge: calls
desktop/frontend/src/platform/services.ts - Service bridge → Desktop host: invokes bindings
desktop/frontend/src/platform/services.ts - Desktop host → Engine service: provides services
desktop/main.go - Engine service → Engine client: sends requests
desktop/internal/services/engine.go - Engine client → Engine process: communicates
- Engine process → Engine API: starts API
engine/cmd/hypomux-engine/main.go - Engine API → Proxy and scheduler: creates proxy
engine/internal/server/server.go - Engine API → TUN lifecycle: activates
engine/internal/server/server.go - Proxy and scheduler → Network destinations: forwards traffic
README.md - Engine API → Network services: uses network controls
- User → AI assistant: requests assistance
README.md - User → Aggregated hotspot: configures hotspot
README.md - User → Steam CDN: uses optimization
README.md - User → Rule subscriptions: manages subscriptions
README.md - User → Update service: checks updates
README.md - AI assistant → Network destinations: contacts model API
README.md