ruvnet/ruflo · error

[vector-db] Using hash-based pseudo-embeddings (no semantic

Error message

[vector-db] Using hash-based pseudo-embeddings (no semantic similarity). Install ruvector or @claude-flow/embeddings for real ML embeddings.

What it means

One-time console warning from generateHashEmbedding: neither ruvector nor @claude-flow/embeddings is available, so the system is producing deterministic hash-based pseudo-embeddings that carry no semantic similarity signal — degraded mode made explicit.

Source

Thrown at v3/@claude-flow/cli/src/ruvector/vector-db.ts:114

  }

  const denom = Math.sqrt(normA) * Math.sqrt(normB);
  return denom === 0 ? 0 : dotProduct / denom;
}

/**
 * Whether the hash-embedding one-time warning has been emitted
 */
let hashEmbeddingWarned = false;

/**
 * Generate a simple hash-based embedding (fallback when ruvector not available)
 * WARNING: Produces deterministic vectors with NO semantic meaning.
 */
function generateHashEmbedding(text: string, dimensions: number = 768): Float32Array {
  if (!hashEmbeddingWarned) {
    hashEmbeddingWarned = true;
    console.warn(
      '[vector-db] Using hash-based pseudo-embeddings (no semantic similarity). ' +
      'Install ruvector or @claude-flow/embeddings for real ML embeddings.'
    );
  }
  const embedding = new Float32Array(dimensions);
  const normalized = text.toLowerCase().trim();

  // Simple hash function
  let hash = 0;
  for (let i = 0; i < normalized.length; i++) {
    hash = ((hash << 5) - hash) + normalized.charCodeAt(i);
    hash = hash & hash; // Convert to 32bit integer
  }

  // Generate pseudo-random embedding based on hash
  for (let i = 0; i < dimensions; i++) {
    embedding[i] = Math.sin(hash * (i + 1) * 0.001) * 0.5 + 0.5;
  }

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install ruvector or @claude-flow/embeddings to get real ML embeddings; hash-based pseudo-embeddings provide no semantic similarity.

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/ruvector/vector-db.ts:114 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/01171e752f1015e4. Report an issue: GitHub.