Home

KadOH is a framework to build P2P applications for browsers and node.js. By implementing the basis of the Kademlia DHT, KadOH lets you build distributed web applications for mobile and desktop devices. With its flexible and extensible design, you can easily adapt KadOH to fit your needs. KadOH is available under the MIT License.

API references

• Node
• Routing Table
• Reactor
• Transport
• Iterative Lookups
• Utilities
  • Deferred
  • Iterative deferred

Resources

• Build a distributed system with KadOH
• DHT simulation
• Browser and NodeJS support
• Debug UI
• Cube logging
• Proxy to mainline DHT

Installation

Install KadOH

The only required dependency is node.js. Take a look at the official manual to install node on your system.

Then run :

npm install kadoh
# or: git clone https://github.com/jinroh/kadoh.git
cd kadoh
npm install

You may also want to install the Jake module globally :

npm install -g jake

For Linux users, if the installation of KadOH's dependencies fails, you may need to install the libexpat-dev package. For Ubuntu/Debian users, run the following command :

sudo apt-get install libexpat-dev

Build and go

Browser

To build the source inside the dist folder run one of the following Jake command :

jake build

This will build two versions of KadOH supporting different transports :

• SimUDP using Socket.io
• XMPP using Strophe.js for XMPP over Bosh

Node.js

If you need to use KadOH in a node.js application, just add kadoh in your package dependencies and use :

var kadoh = require('kadoh');

Thanks

We would like to thank Dr. Tudor Dumitraş, who gave us the honor to work with him during our project and always made available his support.

KadOH is built on top of many open-source libraries and projects:

• Strophe.js
• node-xmpp
• klass
• bncode
• socket.io
• express
• browserify

Authors

Alexandre Lachèze and Pierre Guilleminot