Lunes CMS

Lunes - Vocabulary for your profession.

This is a Django 5 based content management system for the vocabulary trainer app Lunes, a project powered by Tür an Tür – Digitalfabrik gGmbH. The main goal is to develop an application which facilitates migrants to acquire technical and subject-specific vocabulary. Outside contributions to our project are always welcome. For more information on that topic please read our wiki page.

The following packages are required before installing the project (install them with your package manager):

• python3.11 or higher
• python3-pip
• python3-venv
• uv to install the pinned/locked python dependencies
• libpq-dev, python3-dev and build-essential to compile psycopg2
• netcat-openbsd used by the dev scripts to detect when the server is up
• gettext and pcregrep to use the translation features
• ffmpeg for audio processing
• nodejs and npm to build the TypeScript frontend

E.g. on Debian-based distributions, use:

cat requirements.system | xargs sudo apt-get install

git clone git@github.com:digitalfabrik/lunes-cms.git
cd lunes-cms
./tools/install.sh

Some IntelliJ versions do not activate Python virtual environment automatically. In this case you can use IntelliJ together with the direnv plugin and the provided .envrc. It automatically activates the Python virtual environment (.venv) when opening the project.

• Note: The direnv binary has to be installed on your system.

./tools/run.sh

• Go to your browser and open the URL http://localhost:8080
• Default user is "lunes" with password "lunes".

For detailed instructions and the source code reference have a look at our documentation:

The API usage documentation is available here:

Our user manual can be found here:

Copyright © 2026 Tür an Tür - Digitalfabrik gGmbH and individual contributors. All rights reserved.

This project is licensed under the Apache 2.0 License, see LICENSE and NOTICE.md.