Lunes - Vocabulary for your profession.

This is a Django 3 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. For more information please see our wiki page.

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

• python3.11 or higher
• python3-pip
• python3-venv
• libpq-dev to compile psycopg2
• gettext and pcregrep to use the translation features
• ffmpeg for audio processing
• node 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 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.