Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Graph Database for everyday use

Project Description

This program is alpha

(but you can use it, and report bugs and wishes)


Ajgu is graph database with several backends. It’s meant to be an easy to use, just works persistent property graph for people that want to experiment with graph databases. Hopefully, SQLite for graphs.

The supported backends are:

  • Oracle Berkeley Database (also know as sleepycat database, bsddb or simply db)
  • File based

Development happens @



Add property indices. Only str and int can be indexed. To index a property you must register the property name with graph.index(name). This will index properties that have this for both Edge and Vertex so becarful how you name properties. Then you can use txn.element.filter(name=value) where element is as usual edge or vertex to retrieve the interesting elements. Have a look at movielens example for example usage.


  • Major fix in NoTxnBSDDB3. Now it’s really a ACID less (transaction-less) backend.


  • add syncless transaction with sync=False in BSDDB3 storage
  • add movielens latest small load script
  • improve http frontend and move it inside ajgu code
  • add documentation in docs directory using mkdocs


  • ajgu: storage: Add File based backend
  • ajgu: storage: Add Transaction less bsddb3 backend
  • examples: Add conceptnet load script
  • examples: Add mini microblog app


Important changes:

  • Several API changes
  • Transaction support was fully broken, please upgrade if you require transactions.


  • move to unittest.TestCase
  • use uuid4 for identifier generation
  • move Element, Vertex and Edge class to module
  • rework to implement Storage based backend to make future work on multiple backends easier
  • rework now it’s and Element.props with new API (with tests)
  • implement Transaction.edge & Transaction.vertex API via manager classes (cf. Same API as before but element specific. Now you create a vertex with txn.vertex.create('software'), and retrieve an edge with txn.edge.get(ajgu_depends_bsddb).
  • add txn.*.slice
  • index elements by labels to speed up txn.*.label queries.
  • several cleanups, removed old index/query code (uzelmumu module still works)
  • fix pypi example to work with new API


  • add example app
  • better error when magic keys is used but fails
  • fix bug where edge and vertex weren’t not saved
  • fix import error in tests

Getting started


  • python3
  • bsddb3
  • msgpack

bsddb3 must be installed on you system. Dependending on the distribution it’s called db or bdb. If you have a python3-bsddb3 package use that one.

You can use python develop or pip install ajgu but you will need python 3 and bsddb headers.


Feel free to contact me at if you need suppport or want to discuss matters related to graph databases.


  1. What ajgu means?

    ajgu is a beam used in house construction in amazigh language.

  2. Why not use SQLite instead of bsddb3?

    People say sqlite and relationnal database are not meant to store graph data. I believe them. Also key/value stores offer the necessary flexibility to store many kinds of data.

  3. Where can I find a graph server with multi *thread* and *python querying*?

    GraphitiDB I never used it for the real. It’s relying on old version of Tinkerpop.

  4. Are GraphDBs useful beyond prototyping?

    You tell me!

  5. GraphDBs are awesome, where can I learn more?

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node

History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Ajgu-15.07.25.tar.gz (984.9 kB) Copy SHA256 Checksum SHA256 Source Jul 29, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting