Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time


Libre collaborative resource mapper powered by open-knowledge
License Node Code Climate

chat general wiki technical wiki roadmap


This repository hosts source code. Its a collaborative resources mapper project, while yet only focused on exploring books mapping with wikidata and ISBNs

This repository tracks the server-side developments, while the (heavy) client-side can be found here. Client-related technical issues should go in the client repo, while this repo gathers all other technical issues. Non-technical discussions such as feature requests should preferably happen in the roadmap. In doubt, just use your best guess or come ask on the chat :)



This is the installation documentation for a developement environment. For production setup, see: inventaire-deploy

Dependencies to install manually:

  • git, curl (used in some installation scripts), graphicsmagick (used to resize images), inotify-tools (used in API tests scripts)
  • NodeJS (>=6, recommended 12.2), NVM (allows great version update flexibility)
  • a CouchDB (>=1.6, recommended 1.7) instance (on port 5984 for default config)
  • an ElasticSearch (>=2.4) instance (on port 9200 for default config)

To install those on Ubuntu that could give something like:

sudo add-apt-repository ppa:couchdb/stable -y
sudo apt-get update
sudo apt-get install git curl wget graphicsmagick couchdb inotify-tools

# Install ElasticSearch and its main dependency: Java
# You might want to make sure that no previous version of Java is installed first as it might trigger version issues:
# ElasticSearch requires Java 8/Oracle JDK version 1.8. See
# (yes, piping a script to bash is a bad security habit, just as is executing anything on your machine coming from the wild and internet without checking what it does, but we trust this source. For the sake of good practices, you may want to read the script first though ;) )
curl | bash

# Installing NodeJs and NPM using NVM, the Node Version Manager
# (see above text on piping a script)
curl | bash

(reopen terminal)

# Check that the nvm command can be found
# If you get a 'command not found' error, check NVM documentation
nvm install 8

Project development environment installation

git clone
cd inventaire
npm install
# If you haven't done it previously, set an admin on CouchDB and update ./config/local.js accordingly
curl -XPUT http://localhost:5984/_config/admins/yourcouchdbusername -d '"'yourcouchdbpassword'"'

You are all set! You can now start the server (in watch mode so that it reboots on file changes)

npm run watch

If you want to work on the client code, you also need to start Brunch in another terminal

cd client
npm run watch

Installation tips

  • To use executable that are used by the project (such as mocha,couch2elastic4sync), you can either find them in ./node_modules/.bin or install them globally with npm: npm install -g mocha brunch bower supervisor etc.
  • If your computer has many CPU cores, you can make Brunch compile even faster by setting an environment variable: BRUNCH_JOBS=4

Repositories and Branches


  • master: the stable branch. Unstable work should happen in feature-specific branches and trigger pull requests when ready to be merged in master. See Code Contributor Guidelines.


  • master: the stable branch. Unstable work should happen in feature-specific branches and trigger pull requests when ready to be merged in master. See Code Contributor Guidelines.


the repo tracking strings used in the client and emails in all the supported languages. For helping to translate, see


tracking installation scripts and documentation to run inventaire in production

  • master: the main implementation targeting Ubuntu 16.04. Additional branches can be started to document installation on other environments


  • master: tracking docker installation files for development and testing use

Inventaire stack map


Concepts map

the app has a few core concepts:

  • Users
  • Entities : which can be authors (ex: wd:Q353), books (ex: wd:Q393018) and books' specific editions (ex: isbn:9782070389162). The term entities comes from wikidata terminology. See the entities map.
  • Items : instances of book entities that a user says they have. It can be an instance of a work or a specific edition of a work.
  • Transactions : discussion between two users about a specific item with an open transaction mode (giving, lending, selling). Transactions have effects on items: giving and selling an item make it move from the owner to the requester inventory; lending an item shows it as unavailable.
  • Groups: groups of users with one or more admins

concepts map

entities map


For code-related contributions, see the repo wiki to get started, especially the new contributors section. For a more general introduction to contribution, see How to contribute on


see docs


see wiki: API


see Administration

Day-dreaming on future evolutions is a hub for open-knowledge-based peers inventory data. This prototype uses a centralized database to make the early development easier, while being as easy as possible to 'install' and use: well, it's just a "classic" social network. Meanwhile, this repository is public as there is no reason it should always stay centralized: this is a research work in progress, if you can think of a better/more decentralized way for peers to keep their inventory data and share it with others, you are very welcome to join the effort or experiment on your own with what you can find here. The hard point being sharing data between this centralized website and other inventory implementations. Works on a standard data model and an API would be a priority as soon as meaningful.

Ideas for experimentations:

Already experiementing

  • the API should allow a first level of decentralization: having personal clients allowing to manage an inventory out of but that could publish on what belongs there, public and semi public items, while keeping private items private. see Labs settings




a libre collaborative resource mapper powered by open-knowledge, starting with books! 📚





No releases published


No packages published
You can’t perform that action at this time.