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

Embedded — runs locally in your app
Turso Cloud — managed platform with branching, backups
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.

When to Use

Core Concepts

libSQL

Deployment Options

Common Patterns

Encrypted Database

Cloud Sync

Agent Database

Version

Release Note (0.6.0)

Links

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

turso

Turso Database

Links

Quick Navigation