Bulbs   

          a Python persistence framework for graph databases


What is Bulbs?

Bulbs is a Python persistence framework for graph databases that supports 
Python 3 and Python 2.7.

It connects to several graph-database servers, including Neo4j Server and Rexster.

Neo4j Server is Neo4j's open-source REST server, and it is avalble as an
Heroku Add On (http://addons.heroku.com/neo4j).

Rexster is a graph-database REST server optimized for recommendations. 
It is part of the  TinkerPop stack and connects to any Blueprints-enabled 
graph database, including Neo4j, OrientDB, Dex, OpenRDF Sail, and TinkerGraph.

Bulbs supports pluggable backends, and more native bindings are in the works.

Is it ready?

A preview release is out now, and I welecome feedback on how to improve it.
The API will probably change somewhat until we hit 1.0.

What do I need?

* Neo4j Server (http://neo4j.org/), or 
* Rexster  (https://github.com/tinkerpop/rexster)

And a few Python libraries, such as ujson and httplib2.

Where are the docs?

* The 0.2.x docs are online a http://bulbflow.com
* The 0.3.x docs are coming (working on it right now). 

There have been a few API changes in 0.3, but the code is commented. Start at the 
bottom and work your way up:

1. https://github.com/espeed/bulbs/blob/master/bulbs/neo4jserver/client.py
2. https://github.com/espeed/bulbs/blob/master/bulbs/model.py
3. https://github.com/espeed/bulbs/blob/master/bulbs/neo4jserver/graph.py

Where can I get help?

* Neo4j User group (https://groups.google.com/forum/#!forum/neo4j)
* Gremlin User group (https://groups.google.com/forum/#!forum/gremlin-users)
* Email me directly at james@jamesthornton.com.