ruvnet/ruflo · error

Failed to initialize agentic-flow embeddings.${errorDetail}

Error message

Failed to initialize agentic-flow embeddings.${errorDetail} Ensure agentic-flow is installed and ONNX model is downloaded: npx agentic-flow@alpha embeddings init

What it means

Thrown when agentic-flow embeddings cannot initialize. Defense: verify agentic-flow is installed and the ONNX model is downloaded (npx agentic-flow@alpha embeddings init) before selecting this provider.

Source

Thrown at v3/@claude-flow/embeddings/src/embedding-service.ts:703

      for (const p of absolutePaths) {
        if (existsSync(p)) {
          possiblePaths.push(p);
        }
      }
    } catch {
      // fs/path module not available
    }

    // Try each path
    for (const modulePath of possiblePaths) {
      if (await createEmbedder(modulePath)) {
        return;
      }
    }

    const errorDetail = lastError?.message ? ` Last error: ${lastError.message}` : '';
    throw new Error(
      `Failed to initialize agentic-flow embeddings.${errorDetail} ` +
      `Ensure agentic-flow is installed and ONNX model is downloaded: ` +
      `npx agentic-flow@alpha embeddings init`
    );
  }

  async embed(text: string): Promise<EmbeddingResult> {
    await this.initialize();

    // Check our LRU cache first
    const cached = this.cache.get(text);
    if (cached) {
      this.emitEvent({ type: 'cache_hit', text });
      return {
        embedding: cached,
        latencyMs: 0,
        cached: true,
      };

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Run npx agentic-flow@alpha embeddings init to download the ONNX model.
2. Install agentic-flow and confirm it is resolvable from this package.
3. Choose another provider ('transformers' or 'openai' with apiKey) if agentic-flow cannot be installed.

When it happens

Trigger: Thrown at v3/@claude-flow/embeddings/src/embedding-service.ts:703 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/65e578bf90c49375. Report an issue: GitHub.