Seven23 server

Fully manual budget app to track your expenses. Completely opensource, with privacy by design.

• Seven23 official website
• Online documentation
• API specifications swagger and redoc
• Issue tracker
• Code repository
• Docker images

Seven23 server instance is powered by django and django-rest-framework to manage and expose a restful API. It does not include a user interface, which is managed as a totally independant project like seven23_webapp.

Quick start

Requires uv, Python 3.12, and Dart Sass on your PATH (for SCSS; replaces libsass).

Install uv if needed:

curl -LsSf https://astral.sh/uv/install.sh | sh

Install Dart Sass from the standalone releases (or see the installation docs).

See the uv installation docs for alternative methods (Homebrew, pipx, etc.).

uv sync
uv run python manage.py migrate
uv run python manage.py loaddata seven23/models/currency/fixtures/initial_data.json
uv run python manage.py runserver 0.0.0.0:8000

See the installation docs for details.

Commands

uv sync
uv run python manage.py runserver 0.0.0.0:8000
uv run python manage.py test seven23 --settings seven23.settings_tests --parallel auto
uv run python manage.py test seven23.tests.contracts --settings seven23.settings_tests --parallel auto
uv run sphinx-autobuild docs/ docs/_build/html
docker build --pull -t seven23 .
docker run -p 8000:8000 --name seven23 -ti seven23