Skip to main content

TopicDB is a topic map-based graph (NoSQL) database

Project description

TopicDB is a topic map-based graph (NoSQL) database.

Feature Support

  • Pending

TopicDB officially supports Python 3.3–3.6.


To install TopicDB, simply:

$ pip install topic-db

First-Time Use

import os

from import CreateMap
from import InitMap
from topicdb.core.commands.topic.topicexists import TopicExists
from topicdb.core.commands.topic.gettopic import GetTopic

# Set constants.
DATABASE_PATH = os.path.join(os.path.dirname(__file__), 'test-topicmap.db')

# Create database schema.
if not os.path.isfile(DATABASE_PATH):

# Bootstrap default topics.
if not TopicExists(DATABASE_PATH, MAP_IDENTIFIER, 'genesis').execute():

# Retrieve "Genesis" topic (with the accompanying topic identifier in lower case
# for the purpose of testing).
topic = GetTopic(DATABASE_PATH, MAP_IDENTIFIER, 'genesis').execute()


Documentation will be available soon.


A tutorial will be available soon.

How to Contribute

  1. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  2. Write a test which shows that the bug was fixed or that the feature works as expected.
  3. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS.

Release History

0.3.0 (2016-12-30)


  • Added functionality to delete associations (i.e., DeleteAssociation class).

0.2.0 (2016-12-28)


  • Provided OntologyMode (either strict or lenient).
  • Sanitized backing store (SQLite) indexes.

0.1.1 (2016-12-26)


Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
topic_db-0.3.0-py3-none-any.whl (45.9 kB) Copy SHA256 hash SHA256 Wheel py3
topic-db-0.3.0.tar.gz (15.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page