The open-source AI voice studio. Clone, dictate, create.
perf(db): set the SQLite pragmas from a connect hook and clear WAL sidecars on db reset
jamiepineccc092bad034
diff --git a/backend/database/session.py b/backend/database/session.pyindex f67864f1..cb051ec2 100644--- a/backend/database/session.py+++ b/backend/database/session.py@@ -1,10 +1,9 @@"""Engine creation, initialization, and session management."""import logging-import sqlite3 as _sqlite3import uuid-from sqlalchemy import create_engine+from sqlalchemy import create_engine, eventfrom sqlalchemy.orm import sessionmakerfrom .. import config@@ -23,21 +22,6 @@ from .seed import backfill_generation_versions, seed_builtin_presetslogger = logging.getLogger(__name__)-def _make_connection(db_path: str) -> _sqlite3.Connection:- """Open a SQLite connection with WAL journal mode and a 5-second busy timeout.-- WAL allows concurrent readers while a write is in progress (the default- DELETE journal blocks all readers). This matters for voicebox because SSE- status polls and history queries run concurrently with the generation worker- writing to the same database. The busy timeout prevents "database is- locked" errors when two writers briefly contend on the same write slot.- """- conn = _sqlite3.connect(db_path, check_same_thread=False)- conn.execute("PRAGMA journal_mode=WAL")- conn.execute("PRAGMA busy_timeout=5000")- return conn--# Initialized by init_db()engine = NoneSessionLocal = None@@ -54,15 +38,21 @@ def init_db() -> None:engine = create_engine(f"sqlite:///{_db_path}",connect_args={"check_same_thread": False},- # Each connection enables WAL journal mode and sets a 5-second busy- # timeout. WAL allows concurrent readers during a write (the default- # DELETE/ROLLBACK journal blocks all readers), which matters for- # voicebox because SSE status polls and history queries run+ )++ @event.listens_for(engine, "connect")+ def _set_sqlite_pragmas(dbapi_connection, _record) -> None:+ # Each pooled connection enables WAL journal mode and sets a 5-second+ # busy timeout. WAL allows concurrent readers during a write (the+ # default DELETE/ROLLBACK journal blocks all readers), which matters+ # for voicebox because SSE status polls and history queries run# concurrently with the generation worker writing to the same db.# busy_timeout prevents "database is locked" errors when two# connections briefly contend on the same write slot.- creator=lambda: _make_connection(str(_db_path)),- )+ cursor = dbapi_connection.cursor()+ cursor.execute("PRAGMA journal_mode=WAL")+ cursor.execute("PRAGMA busy_timeout=5000")+ cursor.close()SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)diff --git a/docs/content/docs/overview/troubleshooting.mdx b/docs/content/docs/overview/troubleshooting.mdxindex f615b3c6..7668b873 100644--- a/docs/content/docs/overview/troubleshooting.mdx+++ b/docs/content/docs/overview/troubleshooting.mdx@@ -419,12 +419,14 @@ bun run tauri build```bash# macOS-rm ~/Library/Application\ Support/sh.voicebox.app/data/voicebox.db+rm ~/Library/Application\ Support/sh.voicebox.app/data/voicebox.db*# Windows-del %APPDATA%\sh.voicebox.app\data\voicebox.db+del %APPDATA%\sh.voicebox.app\data\voicebox.db*```+The wildcard also removes the `voicebox.db-wal` and `voicebox.db-shm` sidecar files that SQLite keeps next to the database in WAL mode, so the reset starts completely clean.+Restart the app to create a fresh database.## Model Issuesdiff --git a/justfile b/justfileindex 877f1519..9b9a480f 100644--- a/justfile+++ b/justfile@@ -348,12 +348,12 @@ db-init: _ensure-venv# Reset database (delete + reinit)[unix]db-reset:- rm -f {{ backend_dir }}/data/voicebox.db+ rm -f {{ backend_dir }}/data/voicebox.db {{ backend_dir }}/data/voicebox.db-wal {{ backend_dir }}/data/voicebox.db-shmjust db-init[windows]db-reset:- if (Test-Path "{{ backend_dir }}/data/voicebox.db") { Remove-Item -Force "{{ backend_dir }}/data/voicebox.db" }+ Remove-Item -Force -ErrorAction SilentlyContinue "{{ backend_dir }}/data/voicebox.db", "{{ backend_dir }}/data/voicebox.db-wal", "{{ backend_dir }}/data/voicebox.db-shm"just db-init# ─── Utilities ────────────────────────────────────────────────────────