strapi-plugin-embeddings

Automatically generates vector embeddings for Strapi content entries using configurable AI providers (OpenAI, Anthropic, or local models). Hooks into Strapi's lifecycle events to trigger embedding generation on content creation/update, storing dense vectors in PostgreSQL via pgvector extension. Supports batch processing and selective field embedding based on content type configuration.

Executes semantic similarity search against embedded content using vector distance calculations (cosine, L2) in PostgreSQL pgvector. Accepts natural language queries, converts them to embeddings via the same provider used for content, and returns ranked results based on vector similarity. Supports filtering by content type, status, and custom metadata before similarity ranking.

Provides a unified interface for embedding generation across multiple AI providers (OpenAI, Anthropic, local models via Ollama/Hugging Face). Abstracts provider-specific API signatures, authentication, rate limiting, and response formats into a single configuration-driven system. Allows switching providers without code changes by updating environment variables or Strapi admin panel settings.

Stores and indexes embeddings directly in PostgreSQL using the pgvector extension, leveraging native vector data types and similarity operators (cosine, L2, inner product). Automatically creates IVFFlat or HNSW indices for efficient approximate nearest neighbor search at scale. Integrates with Strapi's database layer to persist embeddings alongside content metadata in a single transactional store.

Allows fine-grained configuration of which fields from each Strapi content type should be embedded, supporting text concatenation, field weighting, and selective embedding. Configuration is stored in Strapi's plugin settings and applied during content lifecycle hooks. Supports nested field selection (e.g., embedding both title and author.name from related entries) and dynamic field filtering based on content status or visibility.

Provides bulk operations to re-embed existing content entries in batches, useful for model upgrades, provider migrations, or fixing corrupted embeddings. Implements chunked processing to avoid memory exhaustion and includes progress tracking, error recovery, and dry-run mode. Can be triggered via Strapi admin UI or API endpoint with configurable batch size and concurrency.

Integrates with Strapi's content lifecycle events (create, update, publish, unpublish) to automatically trigger embedding generation or deletion. Hooks are registered at plugin initialization and execute synchronously or asynchronously based on configuration. Supports conditional hooks (e.g., only embed published content) and custom pre/post-processing logic.

Stores and tracks metadata about each embedding including generation timestamp, embedding model version, provider used, and content hash. Enables detection of stale embeddings when content changes or models are upgraded. Metadata is queryable for auditing, debugging, and analytics purposes.

Provides a dedicated admin panel UI within Strapi for configuring embedding settings, monitoring embedding status, and triggering manual operations. Includes forms for provider configuration, field mapping per content type, and batch operation controls. Displays embedding statistics (total embedded entries, last update time, storage size) and error logs.