Configure pgvector extension for PostgreSQL #19

Closed
opened 2025-12-29 23:45:59 +00:00 by cardosofelipe · 0 comments

Description

Set up pgvector extension for vector similarity search (RAG knowledge base).

Requirements

Database Configuration

  • Use pgvector/pgvector:pg17 Docker image
  • Enable pgvector extension via migration
  • Create vector index configuration utilities

Migration

  • Create migration to enable pgvector extension
  • Document vector dimension choices (1536 for OpenAI, 1024 for Cohere)

Testing

  • Verify extension loads correctly
  • Test basic vector operations

Acceptance Criteria

  • Docker Compose uses pgvector image
  • Migration enables pgvector extension
  • Vector operations working (cosine similarity)
  • Health check includes pgvector status
  • Documentation for vector dimension choices

Technical Notes

  • Reference: ADR-007 (pgvector for RAG)
  • Reference: SPIKE-006 (pgvector RAG research)
  • Default to 1536 dimensions (OpenAI embedding size)

Assignable To

devops-engineer agent (Docker), backend-engineer agent (migration)

## Description Set up pgvector extension for vector similarity search (RAG knowledge base). ## Requirements ### Database Configuration - Use `pgvector/pgvector:pg17` Docker image - Enable pgvector extension via migration - Create vector index configuration utilities ### Migration - Create migration to enable pgvector extension - Document vector dimension choices (1536 for OpenAI, 1024 for Cohere) ### Testing - Verify extension loads correctly - Test basic vector operations ## Acceptance Criteria - [ ] Docker Compose uses pgvector image - [ ] Migration enables pgvector extension - [ ] Vector operations working (cosine similarity) - [ ] Health check includes pgvector status - [ ] Documentation for vector dimension choices ## Technical Notes - Reference: ADR-007 (pgvector for RAG) - Reference: SPIKE-006 (pgvector RAG research) - Default to 1536 dimensions (OpenAI embedding size) ## Assignable To devops-engineer agent (Docker), backend-engineer agent (migration)
cardosofelipe added the databasedevopsphase-0 labels 2025-12-29 23:49:39 +00:00
Sign in to join this conversation.