ruvnet/ruflo · error

[neural] Neural substrate not available:

Error message

[neural] Neural substrate not available:

What it means

Log warning in init: dynamically importing or initializing the agentic-flow neural substrate failed (package missing or init error); available is left false so the integration runs its degraded non-neural path.

Source

Thrown at v3/@claude-flow/embeddings/src/neural-integration.ts:90

  private substrate: any = null;
  private initialized = false;
  private available = false;

  constructor(private config: NeuralSubstrateConfig = {}) {}

  /**
   * Initialize neural substrate
   */
  async init(): Promise<boolean> {
    if (this.initialized) return this.available;

    try {
      const { getNeuralSubstrate } = await import('agentic-flow/embeddings');
      this.substrate = await getNeuralSubstrate(this.config);
      await this.substrate.init();
      this.available = true;
    } catch (error) {
      console.warn('[neural] Neural substrate not available:', error instanceof Error ? error.message : error);
      this.available = false;
    }

    this.initialized = true;
    return this.available;
  }

  /**
   * Check if neural features are available
   */
  isAvailable(): boolean {
    return this.available;
  }

  /**
   * Detect semantic drift from baseline
   */
  async detectDrift(input: string): Promise<DriftResult | null> {

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install the neural substrate dependency (agentic-flow with neural extras); without it, neural features are disabled and hash-based embeddings are used.

When it happens

Trigger: Thrown at v3/@claude-flow/embeddings/src/neural-integration.ts:90 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/7ee2702df1de44b9. Report an issue: GitHub.