Introduction

# Add the TuringDB SDK to a uv project
uv add turingdb

# Launch the server
turingdb

# Install the TuringDB SDK with pip
pip install turingdb

# Launch the server
turingdb

# Install the TuringDB JavaScript SDK
npm install turingdb

# Launch the server on a port Node.js accepts
turingdb -p 6686

from turingdb import TuringDB

# Connect to a running TuringDB server
client = TuringDB(host="localhost", port=6666)

# Create a graph and a versioned change
client.create_graph("mygraph")
client.set_graph("mygraph")
change = client.new_change()
client.checkout(change=change)

# Write, commit, and submit
client.query(
    "CREATE (n:Person {name: 'Jane'})"
    "-[e:KNOWS]->(m:Person {name: 'John'})"
)
client.query("COMMIT")
client.query("CHANGE SUBMIT")

# Back to main, query the graph
client.checkout()
client.query("MATCH (n) RETURN n")

import { TuringClient } from "turingdb";

// Connect to a running TuringDB server (started with -p 6686)
const client = new TuringClient({
    url: "http://localhost:6686/query",
    graph: "mygraph",
});

// Query the graph, with a parameter
const [[names]] = await client.queryData(
    `MATCH (n:Person)
     WHERE n.name STARTS WITH $prefix
     RETURN n.name`,
    { parameters: { prefix: "J" } },
);

# Run TuringDB in a container
# (other install methods are preferred:
#  Docker adds some performance loss)
docker run -it turingdbai/turingdb:nightly turingdb