From 1eb348322e2cd20ea1f5e1de30f14fcfc6ecbd18 Mon Sep 17 00:00:00 2001 From: rUv Date: Tue, 2 Dec 2025 17:55:09 +0000 Subject: [PATCH] docs: Add feature overview table to Attention Mechanisms section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replaced single-line intro with structured table matching other sections: - 39 Mechanisms: lists key attention types - Graph Attention: GNN-specific mechanisms - Hyperbolic Attention: curved-space operations - SIMD Optimized: performance benefits - Streaming & Caching: memory and inference optimization đŸ¤– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index fd9db2ce0..4800a95b8 100644 --- a/README.md +++ b/README.md @@ -85,7 +85,13 @@ cargo add ruvector-raft ruvector-cluster ruvector-replication ### Attention Mechanisms (`@ruvector/attention`) -High-performance attention mechanisms for transformers, graph neural networks, and hyperbolic embeddings. Native Rust with NAPI-RS bindings for maximum performance. +| Feature | What It Does | Why It Matters | +|---------|--------------|----------------| +| **39 Mechanisms** | Dot-product, multi-head, flash, linear, sparse, cross-attention | Cover all transformer and GNN use cases | +| **Graph Attention** | RoPE, edge-featured, local-global, neighborhood | Purpose-built for graph neural networks | +| **Hyperbolic Attention** | PoincarĂ© ball operations, curved-space math | Better embeddings for hierarchical data | +| **SIMD Optimized** | Native Rust with AVX2/NEON acceleration | 2-10x faster than pure JS | +| **Streaming & Caching** | Chunk-based processing, KV-cache | Constant memory, 10x faster inference | > **Documentation**: [Attention Module Docs](./crates/ruvector-attention/README.md)