Neo4j wrapper (REST API client) for Node.js


Neo4j Object Modelling for Node.js

Acknowledgements: This library is based heavily on the mongoose ORM for mongodb. The neo4j REST API was based on the 'node-neo4j' library.

npm install neoprene
var neoprene = require('neoprene');

If you have used mongoose before there are a few things which need to be handled differently.

Firstly Node has two types of objects: Nodes and Relationships. When specifying a new model you need to identify the model type that you want.

Note Specifying indexes in Schemas does not work at present. Please see the issues section - pull requests welcome.

var TestNodeSchema = new Schema({
  name: { type:String }
var TestNode = neoprene.model('node', 'TestNode', TestNodeSchema)
var node = new TestNode({name: 'test'}){
var node2 = new TestNode({name: 'test2'}){

Instead of creating joins between tables you need to create relationships. Relationships need a direction. You can create relationships To or From another node.

var FollowsSchema = new Schema({
  start: { type:Date, required: true },
  end: { type:Date, required: true }
neoprene.model('relationship', 'follows', FollowsSchema);
var startDate = new Date(2013, 0, 16);
var endDate = new Date(2014, 0, 16);
node.createRelationshipTo(node2, 'follows', {start: startDate, end: endDate}, function(errrel){

You often want to create a relationship when you are creating a node. It wouldn't be good to make you hit the database twice. When saving a node for the first time you can add in a relationship as well.

var node1 = new TestNode({name: 'no relationship'});
var node2 = new TestNode({name: 'should link to 1'});{
  // you need to supply the linked node by either id or email 
  // you need to supply a type and a direction as well 
  var rel = {id:, type: 'Friend', direction: 'to' };, function(errsavedNode2){
    // other code 

To query / navigate around the graph you start with a single node. You can index nodes to enable quick lookup at a later time.

node.index('Test', 'name',, function(err){
var myFetchedNode;
neoprene.getIndexedNode('Test', 'name', 'test', function(errnode){
  myFetchedNode = node;

Once you have a node you can traverse the graph. You can get Relationships or Nodes. To get relationships you can choose incoming, outgoing or all relationships. In addition you must specify a type or array of relationship types. When getting nodes you can use the adjacentNodes helper or the more complete traverse function.

node.getAllRelationships('follows', function(errrels){
node.adjacentNodes('follows', 2, function(errnodes){

The final way to query the graph is to run a Cypher query against the graph.

var query = [
  'START user=node({userId})',
  'MATCH (user) -[:likes]-> (other)',
  'RETURN other'
var params = {
neoprene.query(query, params, function (errresults) {
  if (err) throw err;
  var likes = (result) {
    return result['other'];
  // ... 

If you're new to Neo4j, read the Getting Started page.