turso

name	turso
description	Turso SQLite database. Covers encryption, sync, agent patterns. Use when working with Turso/libSQL embedded databases, configuring encryption-at-rest, setting up sync replication, or building agent-friendly database patterns. Keywords: Turso, libSQL, embedded, SQLite, encryption, sync.
metadata	{"version":"0.6.0","release_date":"2026-05-14"}

Turso Database

SQLite-compatible embedded database for modern applications, AI agents, and edge computing.

Links

• Documentation
• Changelog
• GitHub

Quick Navigation

Topic	Reference
Installation	installation.md
Encryption	encryption.md
Authorization	auth.md
Sync	sync.md
Agent DBs	agents.md

When to Use

• Embedded SQLite database with cloud sync
• AI agent state management and multi-agent coordination
• Offline-first applications
• Encrypted databases (AEGIS, AES-GCM)
• Edge computing and IoT devices

Core Concepts

libSQL

Turso is built on libSQL, an open-source fork of SQLite with:

• Native encryption (AEGIS-256, AES-GCM)
• Async I/O (Linux io_uring)
• Cloud sync capabilities

Deployment Options

1. Embedded — runs locally in your app
2. Turso Cloud — managed platform with branching, backups
3. Hybrid — local with cloud sync (push/pull)

Common Patterns

Encrypted Database

openssl rand -hex 32  # Generate key
tursodb --experimental-encryption "file:db.db?cipher=aegis256&hexkey=YOUR_KEY"

Cloud Sync

import { connect } from "@tursodatabase/sync";

const db = await connect({
  path: "./local.db",
  url: "libsql://...",
  authToken: process.env.TURSO_AUTH_TOKEN,
});

await db.push(); // local → cloud
await db.pull(); // cloud → local

Agent Database

import { connect } from "@tursodatabase/database";

// Local-first
const db = await connect("agent.db");

// Or with sync
const db = await connect({
  path: "agent.db",
  url: "https://db.turso.io",
  authToken: "...",
  sync: "full",
});

Version

Based on product version: 0.6.0

Release Note (0.6.0)

• Turso 0.6.0 expands the practical client surface with JS/serverless timeouts, interactive transactions, Python SQLAlchemy improvements, npm-based CLI distribution, and a broader SQL surface for local-first/agent workloads.

Links

• Documentation
• Changelog
• GitHub