Noms

Noms is a content-addressable, append-only, peer-to-peer, structured data store.

In other words, noms is git for data.

This repository contains two reference implementations of the noms protocol - one in Go, and one in JavaScript. It also includes a number of tools and sample applications.

Prerequisites

• Go 1.4+
• Python 2.7+ (Note: Python 2.x only, not Python 3.x)
• Node.js 5.3+

Get the code

First, ensure $GOPATH is set correctly. Then:

go get -u -t github.com/attic-labs/noms/...

Build

go install ./...
go test ./...

Run

cd "$GOPATH/src/github.com/attic-labs/noms/clients/counter"
go build
./counter -ldb=/tmp/foo -ds=foo
./counter -ldb=/tmp/foo -ds=foo
./counter -ldb=/tmp/foo -ds=foo

What next?

• Learn the core tools: server, splore, shove, csv_importer, json_importer, xml_importer
• Run sample apps: sfcrime, tagshow (photo viewer)
• NomDL reference (TODO)
• Go SDK reference (TODO)
• JavaScript SDK reference (TODO)