Examples: AI: RAG: Added script to create SQLite vector database

It's run with install.sh.

Author: FunctionPoint

Examples/AI/RAG/Database/Sqlite.code-workspace

@@ -0,0 +1,7 @@
+{
+	"folders": [
+		{
+			"path": "."
+		}
+	]
+}

Examples/AI/RAG/Database/clean.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+
+# Exit script if a step fails
+set -e
+# Set working directory to script directory
+cd "$(dirname "$0")"
+
+echo "==== Cleaning: Example AI RAG database"
+
+rm -f vector.db

Examples/AI/RAG/Database/createSqlite.sql

@@ -1,4 +1,5 @@
--- In DB Browser, load vec0.dll extension from ./node_modules/sqlite-vec<platform>/vec0*
+-- When using DB Browser for SQlite,
+-- first load `vec0.dll` extension from `./node_modules/sqlite-vec<platform>/vec0`*
 
 CREATE VIRTUAL TABLE documents USING vec0(
 	id INTEGER PRIMARY KEY,

Examples/AI/RAG/Database/createSqliteDatabase.js

@@ -0,0 +1,24 @@
+import * as fs from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+import * as sqliteVec from "sqlite-vec"
+
+// Read SQL script.
+let sqlPath = "createSqlite.sql";
+console.log( "Reading SQL script: " + sqlPath );
+let sql = fs.readFileSync( sqlPath ).toString();
+
+// Create and open new database
+let databasePath = "vector.db";
+console.log( "Creating SQLite database: " + databasePath );
+if ( fs.existsSync( databasePath ) )
+	fs.unlinkSync( databasePath );
+let database = new DatabaseSync( databasePath, { allowExtension: true } );
+
+// Load vector extension and create vector table
+sqliteVec.load( database );
+database.exec( sql );
+
+// Close
+database.close();
+
+console.log( "Done." );

Examples/AI/RAG/Database/install.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# This script creates the SQLite example database
+
+# Exit script if a step fails
+set -e
+# Set working directory to script directory
+cd "$(dirname "$0")"
+
+echo "==== SQLite vector database"
+
+npm install
+
+node createSqliteDatabase.js

Examples/AI/RAG/Database/package-lock.json

@@ -0,0 +1,6 @@
+{
+	"type": "module",
+	"dependencies": {
+		"sqlite-vec": "^0.1.9"
+	}
+}

Examples/AI/RAG/Database/package.json

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# Exit script if a step fails
+set -e
+# Set working directory to script directory.
+cd "$(dirname "$0")"
+
+# Check confirmation argument '-y'
+
+if
+	[[ ! "$1" == "-y" ]]
+then
+	echo "Script must be called with argument '-y' to update."
+	echo "Aborting."
+	exit 1
+fi
+
+# Perform update
+
+echo "==== Updating: Example AI RAG SQLite database"
+npx npm-check-updates -u --cooldown 7d
+./install.sh

Examples/AI/RAG/Database/update.sh

@@ -7,3 +7,6 @@ cd "$(dirname "$0")"
 echo "==== Cleaning: Example AI RAG"
 
 rm -fr ./out
+
+# Clean the database
+./Database/clean.sh

Examples/AI/RAG/clean.sh

@@ -25,7 +25,10 @@ The SQLite database is included in Node.js, it does not need to be installed sep
 An SQLite extension to enable vector storage.\
 The binary of the actual extension is included in the npm package,\
 in the folder `node_modules/sqlite-vec-<platform>`.\
-The app loads in automatically.
+The app loads it automatically.
+
+The `install.sh` script for this app creates the SQLite `vector.db` database automatically.\
+So the manual steps below are not necessary to run the app.
 
 ### DB Brower for SQLite
 
@@ -41,6 +44,10 @@ Open DB Browser and activate the vector extension through the menu:
 Then open the SQL script `Database/createSqlite.sql` .\
 Run it to table `documents` also containing embedding vectors.
 
+2026-08-06: MacOS note.\
+This step currently fails on MacOS 26.6 on Intel (ARM not tested).\
+Use the install script to create the datebase on MacOS.
+
 ## Postgres with vectors
 
 An alternative to SQLite, you can use Postgres.