Table of contents
- Introduction
- Installation
- Connect
- API Reference
- Specifications
- Extensions
- Javascript
- Python
- Install Module
- Getting Started
- Additional Python ressources
- CLI
- Manual page
- Changelog
damas-core is a web service back-end programmed in NodeJS. Its main features are :
- JSON database model with graph capabilities
- Multi-user
- Server extensions
- Client API for Python, Javascript, command line and events
Usage
Run using Docker
Copy the files /docker/compose.yaml, /docker/damas.json and /docker/nginx.conf from this repository and run:
docker compose up
Then in a web browser, open http://localhost.
Run from Sources
Clone this repository and run:
cd server-nodejs
# install dependencies
npm install
# run server
node .
Then in a web browser, open http://localhost:8090.
Read the Installation for more details and to configure your server for your needs and Connect clients to a running server.
Demo
A public demo server is available at https://demo.damas.io
Directory Structure
đ damas-core/ âââ đ cli/ Bash + curl command line client âââ đ docs/ inline documentation â âââ đ 1-Installation.md â âââ đ 2-Connect.md â âââ đ 3-API-Reference.md â âââ đ 4-Specifications.md âââ đ docker/ deployment package âââ đ js/ Javascript client API âââ đ py/ Python client API âââ đ server-nodejs/ HTTP server (NodeJS/Express) â âââ đ extensions/ âââ đ server-tests/ server Jasmine unit tests âââ đ www/ served files âââ đ CHANGELOG.md releases notes âââ đ LICENSE GNU GPLv3 license âââ đ README.md this file
Contributors
Remy Lalanne - Project lead
Thibault Allard
Julie Aresu
Aymeric Cadier
Sebastien Courtois
Ghislain Dugat
Joaquin Galvan Angeles
Stephane Hoarau
Matthieu Humeau
Mathieu Lalanne
François Morlet
Axel Pisani
Axel Prat
Mathieu Valero
Quentin Villecroze
See Contributing for coding conventions and unit testing.
Context
damas is originaly created by PRIMCODE to support the production of 3D animated feature films and TV series as a digital asset manager and a universal meta data indexer (to index files, tasks, users etc) and its core was released as libre software in 2015 under the GNU GPLv3 license. Here is a chronology of some animated movies and TV series which used it:
- Igor - 2008 - IMDb⤴ Wikipedia⤴
- Tatonka - 2010-2011 IMDb⤴ Wikipedia⤴
- A Monster in Paris - 2011 - IMDb⤴ Wikipedia⤴
- Approved for Adoption - 2012 - IMDb⤴ Wikipedia⤴
- Zou - 2012-2018 - IMDb⤴ Wikipedia⤴
- Mademoiselle Zazie - 2013 - IMDb⤴ Wikipedia⤴
- Mia - 2014 - IMDb⤴
- Zorro the Chronicles - 2015-2016 - IMDb⤴ Wikipedia fr⤴
- Zombillenium - 2017 - IMDb⤴ Wikipedia⤴
- White-Fang - 2018 - IMDb⤴ Wikipedia⤴
- Gigantosaurus - 2019 - IMDb⤴ Wikipedia⤴
- Taffy - 2019 - IMDb⤴ Wikipedia⤴
- Droners - 2020 - IMDb⤴
- Nefertine on the Nile - 2021 - IMDb⤴
- Weird Waters - 2022 - IMDb⤴
- Heros à MoitiÊ - 2022 - IMDb⤴
- Hello Kitty - Super Style! - 2022 - IMDb⤴ Wikipedia⤴
- Le petit Nicolas : qu'est-ce qu'on attend pour être heureux ? - 2022 - IMDb⤴ Wikipedia⤴
- Mars Express - 2023 - IMDb⤴ Wikipedia fr⤴
- Angelo dans la forêt mystÊrieuse - 2024 - IMDb⤴ Wikipedia fr⤴
- Stitch Head - 2025 - IMDb⤴ Wikipedia⤴
- Les LÊgendaires - 2025 IMDb⤴ Wikipedia fr⤴
Related Links
http://damas-software.org is a website which presents the projects related to damas-core
https://syncplanet.io is a Saas using damas-core as backend
https://hub.docker.com/r/primcode/damas-core the ready-to-install docker images
http://dabox.io is collaborative platform for architecture using damas-core as backend
https://github.com/PRIMCODE/damas-flow is an interface to make directed graphs on top of damas-core
https://github.com/PRIMCODE/damas-dashboard is a web control center and admin interface to index files, in production but not packaged for distribution. Get in touch if interested
http://primcode.com PRIMCODE is the company behind the development, the distribution and the maintenance of damas-core
License
GPL License(GPLV3)
Copyright(c) 2026 Remy Lalanne (remy at primcode dot com)
damas-core is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
damas-core is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with damas-core. If not, see http://www.gnu.org/licenses/.