ruvnet/ruflo · error

[MoE] Failed to initialize router:

Error message

[MoE] Failed to initialize router:

What it means

Log warning from getMoERouter's singleton setup: the background initialization of the MoE router (which loads persisted weights) failed, so the router runs untrained/default while still being returned to callers.

Source

Thrown at v3/@claude-flow/neural/src/moe-router.ts:804

// ============================================================================
// Singleton Instance
// ============================================================================

let moeRouterInstance: MoERouter | null = null;

/**
 * Get singleton MoE router instance
 *
 * @param config - Optional configuration (only used on first call)
 * @returns MoE router instance
 */
export function getMoERouter(config?: Partial<MoERouterConfig>): MoERouter {
  if (!moeRouterInstance) {
    moeRouterInstance = new MoERouter(config);
    // Initialize in background (load weights)
    moeRouterInstance.initialize().catch((err) => {
      console.warn('[MoE] Failed to initialize router:', err);
    });
  }
  return moeRouterInstance;
}

/**
 * Reset singleton instance (for testing)
 */
export function resetMoERouter(): void {
  moeRouterInstance = null;
}

/**
 * Factory function to create new router
 */
export function createMoERouter(config?: Partial<MoERouterConfig>): MoERouter {
  return new MoERouter(config);
}

View on GitHub (pinned to fa13ee4ad6)

Solutions

  1. Check the MoE router configuration (expert count, dimensions) and the initialization error detail; fix the invalid config value.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at v3/@claude-flow/neural/src/moe-router.ts:804 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/4fab9956a35ff506. Report an issue: GitHub.