faiss

Build and query dense-vector FAISS indexes for nearest-neighbor search.

19|4|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill faiss-carterwayneskhizeine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faiss
Source: https://github.com/carterwayneskhizeine/hermes-agent-windows-R/tree/main/optional-skills/mlops/faiss
Command: npx skills add https://github.com/carterwayneskhizeine/hermes-agent-windows-R --skill faiss-carterwayneskhizeine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires faiss-cpu, faiss-gpu, numpy, and includes references (resource) components.

What problem does it solve?

FAISS solves the problem of performing fast nearest-neighbor and similarity search over large collections of dense vectors, where brute-force search is too slow or too memory-intensive.

Core Features & Use Cases

  • High-performance similarity search: Retrieve top-k nearest vectors efficiently for large embedding sets, including GPU-accelerated runs.
  • Multiple index types: Choose exact search (Flat) or approximate search optimized for speed/memory tradeoffs (IVF, HNSW, PQ, IVFPQ).
  • Persistence and interoperability: Save and load indexes, and integrate with common RAG/vector-store frameworks for retrieval workflows.

Quick Start

Use the faiss skill to build an index and run k-NN search over your embedding vectors using the FAISS Python library, by installing faiss-cpu (or faiss-gpu) and then creating an IndexFlatL2 (for exact L2 search) or an appropriate approximate index type for your dataset size.

Frequently Asked Questions about faiss

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform similarity search over a billion-scale vector dataset?

Similarity search at billion scale requires building approximate nearest-neighbor indexes like IVF or HNSW using FAISS, enabling fast dense-vector retrieval without brute-force scanning. You train the index on a data subset, add embeddings, then query top-k neighbors efficiently.

When should I use Flat versus IVFPQ indexes for vector search?

Use Flat indexes for exact similarity search when accuracy is critical and memory is sufficient. Switch to IVFPQ or HNSW approximate indexes when handling large embedding sets where speed and memory optimization outweigh minor accuracy trade-offs.

Can I use GPU acceleration for RAG retrieval workflows with FAISS?

Yes, GPU acceleration is supported for RAG retrieval by installing faiss-gpu, which speeds up dense-vector indexing and k-NN search operations. The framework integrates with common vector-store frameworks for retrieval pipelines.

How do I save and load FAISS indexes for embedding retrieval?

FAISS supports persistence by allowing you to save built indexes to disk and load them back into memory for continuous embedding retrieval. This enables index reuse across sessions without retraining or re-adding vectors.

What's the best way to retrieve top-k nearest neighbors for a recommendation system?

Retrieve top-k nearest neighbors by building an appropriate FAISS index—Flat for exact matches or IVF and HNSW for approximate search—then querying user or item embeddings to return the most similar vectors efficiently.

Does FAISS work with numpy arrays for clustering and recommendation tasks?

Yes, FAISS works directly with numpy arrays, accepting dense vectors as input for indexing, clustering, and recommendation system queries. You generate embeddings as numpy arrays, then train, add, and search the index using standard array formats.