Open Source Neo4j driver for iOS, Linux and macOS

What's New

SSL certificate fix

  • Makes it so that SSL connections no longer need their own certificate
  • Removed dependency on ShellOut for macOS and Linux
  • Added support back in for iOS, macOS, Linux, tvOS and watchOS


Thomas Anderson is a computer programmer who maintains a double life as "Neo" the hacker. - Combination of Neo and Thomas


Theo is an open-source framework written in Swift that provides an interface for interacting with Neo4j.


  • CRUD operations for Nodes and Relationships
  • Transaction statement execution
  • Supports iOS, macOS and Linux


  • iOS 10.0 or higher / macOS 10.12 or higher / Ubuntu Linux 14.04 or higher
  • Xcode 8.3.2 or newer for iOS or macOS
  • Swift 3.1.1


Because this framework is open source it is best for most situations to post on Stack Overflow and tag it Theo. If you do find a bug please file an issue or issue a PR for any features or fixes.


You can install Theo in a number of ways

###Swift Package Manager Add the following line to your Package dependencies array:

.Package(url: "”, majorVersion: 3, minor: 0)

Run swift build to build your project, now with Theo included and ready to be used from your source

###CococaPods Add the following to your Podfile:

source ''
platform :ios, ‘10.0’

target '<Your Target Name>' do
  pod ‘Theoend

Run pod install to configure your updated workspace. Open the .xcworkspace generated, your project is now ready to use Theo

###Carthage Add the following to your Cartfile:

github "GraphStory/neo4j-ios" ~> 3.1

Run carthage update --platform iOS to build the framework and drag the built Theo.framework into your Xcode project.

###git submodule

  1. Add it as a submodule to your existing project. git submodule add
  2. Open the Theo folder, and drag Theo.xcodeproj into the file navigator of your Xcode project.
  3. In Xcode, navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar.
  4. In the tab bar at the top of that window, open the "Build Phases" panel.
  5. Expand the "Link Binary with Libraries" group, and add Theo.framework.
  6. Click on the + button at the top left of the panel and select "New Copy Files Phase". Rename this new phase to "Copy Frameworks", set the "Destination" to "Frameworks", and add Theo.framework.




Example: not

Without authentication

let theo: Client = Client(baseURL: "")

With authentication

let theo: Client = Client(baseURL: "", user: "username", pass: "password")

Fetch meta for a graph

theo.metaDescription({(meta, error) in
    print("meta in success \(meta) error \(error)")

Fetch a node via id

theo.fetchNode("IDToFetch", completionBlock: {(node, error) in    
    print("meta in success \(node!.meta) node \(node) error \(error)")

Create a node

Without Labels

let node = Node()
let randomString: String = NSUUID().UUIDString

node.setProp("propertyKey_1", propertyValue: "propertyValue_1" + randomString)
node.setProp("propertyKey_2", propertyValue: "propertyValue_2" + randomString)

theo.createNode(node, completionBlock: {(node, error) in
    print("new node \(node)")

With Labels

let node = Node()
let randomString: String = NSUUID().UUIDString

node.setProp("propertyKey_1", propertyValue: "propertyValue_1" + randomString)
node.setProp("propertyKey_2", propertyValue: "propertyValue_2" + randomString)
node.addLabel("customLabelForNode_" + randomString)

theo.createNode(node, completionBlock: {(node, error) in
    print("new node \(node)")


let node = Node()
let randomString: String = NSUUID().UUIDString        

node.setProp("succesfullyAddNodeWithLabel_1", propertyValue: "succesfullyAddNodeWithLabel_1" + randomString)
node.setProp("succesfullyAddNodeWithLabel_2", propertyValue: "succesfullyAddNodeWithLabel_2" + randomString)
node.setProp("succesfullyAddNodeWithLabel_3", propertyValue: 123456)
node.addLabel("test_008_succesfullyAddNodeWithLabel_" + randomString)

theo.createNode(node, labels: node.labels, completionBlock: {(_, error) in
  print("new node \(node)")

Update properties for a node

let updatedPropertiesDictionary: [String:String] = ["test_update_property_label_1": "test_update_property_lable_2"]

theo.updateNode(updateNode!, properties: updatedPropertiesDictionary,
    completionBlock: {(node, error) in

Deleting a node

theo.deleteNode("IDForDeletion", completionBlock: {error in
    print("error \(error?.description)")

Create a relationship

var relationship: Relationship = Relationship()

relationship.relate(parentNodeInstance, toNode: relatedNodeInstance, type: RelationshipType.KNOWS)

// setting properties is optional
relationship.setProp("my_relationship_property_name", propertyValue: "my_relationship_property_value")

theo.createRelationship(relationship, completionBlock: {(node, error) in
    print("meta in success \(node!.meta) node \(node) error \(error)")

Delete a relationship

theo.fetchRelationshipsForNode("nodeIDWithRelationships", direction: RelationshipDirection.ALL, types: nil, completionBlock: {(relationships, error) in

    if let foundRelationship: Relationship = relationships[0] as Relationship! {
        if let relMeta: RelationshipMeta = foundRelationship.relationshipMeta {
            relationshipIDToDelete = relMeta.relationshipID()
        theo.deleteRelationship(relationshipIDToDelete!, completionBlock: {error in


Update a relationship

let updatedProperties: Dictionary<String, AnyObject> = ["updatedRelationshipProperty" : "updatedRelationshipPropertyValue"]

theo.updateRelationship(foundRelationshipInstance, properties: updatedProperties, completionBlock: {(_, error) in


Execute a transaction

let createStatement: String = "CREATE ( bike:Bike { weight: 10 } ) CREATE ( frontWheel:Wheel { spokes: 3 } ) CREATE ( backWheel:Wheel { spokes: 32 } ) CREATE p1 = bike -[:HAS { position: 1 } ]-> frontWheel CREATE p2 = bike -[:HAS { position: 2 } ]-> backWheel RETURN bike, p1, p2"        
let resultDataContents: Array<String> = ["row", "graph"]
let statement: Dictionary <String, AnyObject> = ["statement" : createStatement, "resultDataContents" : resultDataContents]
let statements: Array<Dictionary <String, AnyObject>> = [statement]

theo.executeTransaction(statements, completionBlock: {(response, error) in
    print("response \(response) and error \(error?.description")

Execute a cypher query

        let theo: Client = Client(baseURL:, user: configuration.username, pass: configuration.password)
        let cyperQuery: String = "MATCH (u:User {username: {user} }) WITH u MATCH (u)-[:FOLLOWS*0..1]->(f) WITH DISTINCT f,u MATCH (f)-[:LASTPOST]-(lp)-[:NEXTPOST*0..3]-(p) RETURN p.contentId as contentId, p.title as title, p.tagstr as tagstr, p.timestamp as timestamp, p.url as url, f.username as username, f=u as owner"
        let cyperParams: Dictionary<String, AnyObject> = ["user" : "ajordan"]

        theo.executeCypher(cyperQuery, params: cyperParams, completionBlock: {(cypher, error) in
            println("response from cyper \(cypher)")

Integration Tests


There is a file called, TheoConfig.json.example which you should copy to TheoConfig.json. You can add your username, password and baseUrl to this config and the test classes use these instead of having to modify any actual class files. TheoConfig.json is in the .gitignore so you don't have to worry about creds being committed.


  • Select the unit test target
  • Hit CMD-U



  • Swift Tools
View More Packages from this Author


  • None
Last updated: Fri Mar 24 2023 05:21:26 GMT-0500 (GMT-05:00)