ruvnet/ruflo · error

[embeddings] Auto-install failed:

Error message

[embeddings] Auto-install failed:

What it means

Log warning in the auto-install helper: the npm install of agentic-flow@alpha or the subsequent model initialization command failed, so automatic provisioning of the embedding backend is abandoned and the caller must handle the package being unavailable.

Source

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

  const execAsync = promisify(exec);

  try {
    // Check if already available
    if (await isAgenticFlowAvailable()) {
      return true;
    }

    console.log('[embeddings] Installing agentic-flow@alpha...');
    await execAsync('npm install agentic-flow@alpha --save', { timeout: 120000 });

    // Initialize the model
    console.log('[embeddings] Downloading embedding model...');
    await execAsync('npx agentic-flow@alpha embeddings init', { timeout: 300000 });

    // Verify installation
    return await isAgenticFlowAvailable();
  } catch (error) {
    console.warn('[embeddings] Auto-install failed:', error instanceof Error ? error.message : error);
    return false;
  }
}

/**
 * Create embedding service based on configuration (sync version)
 * Note: For 'auto' provider or smart fallback, use createEmbeddingServiceAsync
 */
export function createEmbeddingService(config: EmbeddingConfig): IEmbeddingService {
  switch (config.provider) {
    case 'openai':
      return new OpenAIEmbeddingService(config as OpenAIEmbeddingConfig);
    case 'transformers':
      return new TransformersEmbeddingService(config as TransformersEmbeddingConfig);
    case 'mock':
      return new MockEmbeddingService(config as MockEmbeddingConfig);
    case 'agentic-flow':
      return new AgenticFlowEmbeddingService(config as AgenticFlowEmbeddingConfig);

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install the embeddings dependency manually (npm install agentic-flow or @xenova/transformers) since auto-install failed; check npm permissions and network access.

When it happens

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