localstack-extension-pgvector 0.1.2

LocalStack extension to enable pgvector automatically

LocalStack pgvector Extension 🚀

localstack-extension-pgvector is a professional extension for LocalStack designed to simplify the development of AI-driven applications and Vector Search. This extension automatically enables pgvector on every PostgreSQL instance running in LocalStack and provides a web interface via pgweb.

---

✨ Key Features

• Auto-Enable pgvector: Automatically executes CREATE EXTENSION IF NOT EXISTS vector; when a PostgreSQL container starts.
• pgweb Integration: Automatically launches a pgweb (Web UI) instance as a sidecar to visualize your vector data.
• Seamless Integration: Supports standard RDS and PostgreSQL instances in LocalStack.
• Health Check Endpoint: Verify extension status via a dedicated HTTP endpoint.

---

🛠️ Installation

Using LocalStack Dashboard (Recommended)

Click the badge above or open the LocalStack Extensions Dashboard and enter this repository URL: https://github.com/Nocturnailed-Community/localstack-extension-pgvector

Using CLI

Use the following command to install the extension locally:

localstack extensions install "https://github.com/Nocturnailed-Community/localstack-extension-pgvector"

Local Development (Editable Mode)

1. Clone this repository.
2. Run:

   pip install -e .
   

3. Restart LocalStack.

🐳 Using Docker Compose

For easy local development, you can use the provided docker-compose.yml:

1. Start LocalStack:

   docker compose up -d
   

2. The extension will be installed automatically. Check status:

   curl http://localhost:4566/pgvector-status
   

---

🛠️ Usage

1. Start LocalStack:

   localstack start
   

2. Launch PostgreSQL/RDS: Use AWS CLI or SDK to create a database instance. Example:

   awslocal rds create-db-instance --db-instance-identifier mydb --engine postgres --allocated-storage 20
   

3. Access pgweb: Open your browser and navigate to http://localhost:8081 to view your data.
4. Check Status: Verify if the extension is active: http://localhost:4566/pgvector-status

---

📊 Manual Verification

You can run the following query to ensure pgvector is enabled:

SELECT * FROM pg_extension WHERE extname = 'vector';

---

👨‍💻 Contributors

• Muhammad Ikhwan Fathulloh (@Muhammad-Ikhwan-Fathulloh)
• Email: [e-mail]

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ by Noc Lab as part of the LocalStack ecosystem.