gorm.md

title	gorm integration
description	The gosqlite.org/gorm dialector — a CGo-free drop-in for glebarez/sqlite and gorm.io/driver/sqlite, shipped as its own module.
sidebar	order 4

gorm

gosqlite.org/gorm is a gorm.Dialector — a drop-in for both glebarez/sqlite and the official gorm.io/driver/sqlite. It ships as its own module, so the gosqlite core stays free of gorm.io/gorm; add it with go get gosqlite.org/gorm.

import (
	"gorm.io/gorm"
	sqlite "gosqlite.org/gorm"
)

db, _ := gorm.Open(sqlite.Open("file:my.db?_pragma=foreign_keys(1)"), &gorm.Config{})

sqlite.Open(dsn) and sqlite.New(sqlite.Config{...}) are both provided so either upstream import path swaps in unchanged. For the modern typed entry, also import the root gosqlite.org (also package sqlite) and alias the dialector sqlitegorm:

import (
	sqlite "gosqlite.org"
	sqlitegorm "gosqlite.org/gorm"
)

db, _ := sqlitegorm.OpenConfig(sqlite.Config{Path: "my.db", Pragmas: sqlite.RecommendedPragmas()})

See Configuration; coverage matrix: dev/coverage/gorm.md.

Vector & full-text search in an ORM

For an ORM with native vector (sqlite-vec) and full-text (FTS5) search — declarative vec: / fts: tags, AutoMigrate-provisioned sidecars kept in sync on every write, and typed ranked results — use LiteORM, the data layer built on gosqlite.

If you're staying on gorm.io/gorm, drive gosqlite's gorm-free vec / fts primitives directly via db.Exec / db.Raw over the underlying *sql.DB.

Runnable: gorm/examples/getting-started/ and gorm/examples/from-glebarez/.