libSQL Swift

Databases for Swift multi-tenant AI Apps.

Turso · Docs · Quickstart · SDK Reference · Blog & Tutorials

Features

• 🔌 Works offline with Embedded Replicas
• 🌎 Works with remote Turso databases
• ✨ Works with Turso AI & Vector Search
• 📱 Works with macOS, iPadOS, tvOS, watchOS & iOS

Warning

This SDK is currently in technical preview. Join us in Discord to report any issues.

Install

Add tursodatabase/libsql-swift to your SwiftPM dependencies:

import PackageDescription

let package = Package(
    // ...
    dependencies: [
        .package(url: "https://github.com/tursodatabase/libsql-swift", from: "0.1.1"),
    ],
    // ...
)

Quickstart

The example below uses Embedded Replicas and syncs data every 1000ms from Turso.

import Libsql

let db = try Database(
    path: "./local.db",
    url: "TURSO_DATABASE_URL",
    authToken: "TURSO_AUTH_TOKEN",
    syncInterval: 1000
)

let conn = try db.connect()

try conn.execute("
  CREATE TABLE IF NOT EXISTS users (
      id INTEGER PRIMARY KEY AUTOINCREMENT,
      name TEXT
  );
  INSERT INTO users (name) VALUES ('Iku');
")

try conn.query("SELECT * FROM users WHERE id = ?", 1)

Documentation

Visit our official documentation.

Support

Join us on Discord to get help using this SDK. Report security issues via email.

Contributors

See the contributing guide to learn how to get involved.