Use TuringDB

Start using TuringDB using TuringDB python SDK.

1. Create your TuringDB account

   Sign up on console.turingdb.ai

   You need to have credits (free or purchased) to create TuringDB instances

   Use your free credits (with your promo code or contact us at [e-mail] to get your code) or directly purchase new credits (in Profile → Settings → Billing).

2. Create your instance in the TuringDB Cloud UI

   In Database Instance -> Create your first instance

3. Copy your Instance ID from the Database Instances management page

   Keep the instance ID as you will need it on step 5)

4. Get API Key from the Settings in UI

   -> Click on your profile icon (bottom left) -> click on Settings (on the left panel of the pop-up window) -> Click on the API Keys section -> copy your API Key (keep it as you will need it on step 5)

5. Install TuringDB Python SDK

   Using pip:

   pip install turingdb
   

   or using the uv package manager (you will need to create a project first):

   uv add turingdb
   

6. Exemple to create and query a graph

   Create graph → list graph → create node & create edge → commit → list graphs → match query

   Python SDK

   from turingdb import TuringDB
   
   client = TuringDB(
       instance_id="...", # Replace by your instance id
       auth_token="...",  # Replace by your API token
   )
   
   # Create a new graph
   client.query('CREATE GRAPH mygraph')
   client.set_graph('mygraph')
   
   # Create a new change on the graph
   change = client.query("CHANGE NEW")["Change ID"][0]
   
   # Checkout into the change
   client.checkout(change=change)
   
   # Create a node Person (Jane) - Edge (knows) - node (John)
   client.query('CREATE (n:Person {Name:"Jane"})-[e:knows]-(m:Person {Name:"John"})')
   
   # Commit the change
   client.query("COMMIT")
   client.query("CHANGE SUBMIT")
   

   User Interface

   You can build a workflow (in the UI and very soon in Python with our open-source agentic & analytical workflow package) to integrate data in the TuringDB graph database.

   See UI Tutorial

   See Workflow Exemples

7. Visualise the graph you have created in TuringDB

   Open the graph visualiser from the instance running your TuringDB graph, click on the 3 dots in the top right and then on Access UI

   Exemple of a biological interaction graph built in TuringDB:

   1. Choose on the top right the graph
   2. Search & select a node(s) of interest (magnifying glass button on the left)
   3. Then go to visualiser (network logo) and you can start exploring paths, expanding neighbours, inspect nodes (parameters, hyperlinks, and texts stored on the nodes)
      

You are done!