#libsql #sqld #driver #http


HTTP-based client for libSQL and sqld

117 releases (31 breaking)

0.33.2 Nov 24, 2023
0.32.0 Sep 25, 2023
0.31.8 Jul 11, 2023
0.16.2 Mar 31, 2023

#31 in HTTP client

Download history 916/week @ 2023-08-17 1139/week @ 2023-08-24 949/week @ 2023-08-31 1185/week @ 2023-09-07 1229/week @ 2023-09-14 1097/week @ 2023-09-21 1119/week @ 2023-09-28 1276/week @ 2023-10-05 1207/week @ 2023-10-12 1517/week @ 2023-10-19 1828/week @ 2023-10-26 1070/week @ 2023-11-02 1005/week @ 2023-11-09 674/week @ 2023-11-16 1151/week @ 2023-11-23 1805/week @ 2023-11-30

4,849 downloads per month
Used in 3 crates


1.5K SLoC

Rust libSQL client library

libSQL Rust client library can be used to communicate with sqld natively over HTTP protocol with native Rust interface.

At the moment the library works with the following backends:

  • local
  • reqwest
  • hrana
  • Cloudflare Workers environment (optional)


In order to use the database in your project, just call libsql_client::Client::from_env(), or any of the other constructors:

let db = libsql_client::Client::from_env().await?;

The only thing you need to provide is an env variable with the database URL, e.g.

export LIBSQL_CLIENT_URL="file:////tmp/example.db"

for a local database stored in a file, or

export LIBSQL_CLIENT_URL="https://example.turso.io"

for a remote database connection.

You can also explicitly use a specific backend. Examples of that are covered in the next paragraphs.


In order to connect to the database, set up the URL to point to a local path:

export LIBSQL_CLIENT_URL = "/tmp/example.db"

local_backend feature is enabled by default, so add the dependency like this:

cargo add libsql-client

Example for how to connect to the database and perform a query:

    let db = libsql_client::local::Client::from_env()?;
    let response = db
        .execute("SELECT * FROM table WHERE key = 'key1'")

Cloudflare Workers

In order to connect to the database, set up the following variables in .dev.vars, or register them as secrets:

LIBSQL_CLIENT_URL = "https://your-db-url.example.com"
LIBSQL_CLIENT_TOKEN = "<your-jwt>"

Add it as dependency with workers_backend backend enabled. Turn off default features, as they are not guaranteed to compile to wasm32-unknown-unknown, which is required in this environment:

cargo add libsql-client --no-default-features -F workers_backend

Example for how to connect to the database and perform a query from a GET handler:

router.get_async("/", |_, ctx| async move {
    let db = libsql_client::workers::Client::from_ctx(&ctx).await?;
    let response = db
        .execute("SELECT * FROM table WHERE key = 'key1'")


~364K SLoC