The backend app of Project Amber, a task list app
Não pode escolher mais do que 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
Timur Demin dd4906833a
Merge branch 'develop' at v0.0.5
há 7 meses
bin Add an example docker-compose config há 1 ano
doc BREAKING: switch to versioned API URI scheme há 11 meses
project_amber Bump v0.0.5 há 7 meses
.dockerignore Make the app run with Docker há 1 ano
.drone.yml Remove excessive pip install há 7 meses
.gitignore Add VSCode dev internals to gitignore há 11 meses
.pylintrc Stop pylint from complaining on code that is easy to read há 11 meses
Dockerfile Bump Python version in Dockerfile há 7 meses
LICENSE.txt Initial commit há 1 ano
Pipfile Add mypy config há 7 meses
Pipfile.lock Add mypy config há 7 meses Migrate to pipenv for dependency management há 11 meses
docker-compose.yml Add an example docker-compose config há 1 ano
requirements.txt Add mypy config há 7 meses
setup.cfg Add mypy config há 7 meses Bump v0.0.5 há 7 meses

Amber Backend

This is the backend app of Project Amber, a task list app.

This is a basic Flask/SQLAlchemy app that takes care of syncing tasks between devices.


The config file is a JSON file that is loaded from either ./config.json or /etc/amber.json, whichever is found first.

Example config:

    "database": "sqlite:///file.db", // SQLAlchemy database URI
    // see
    "allow_signup": false, // whether to allow /api/signup or not
    "loglevel": 0, // 0: errors, 1: warnings, 2: info
    "domain": "https://your.domain.tld" // full domain with HTTPS, needed for CORS

If there are environment variables AMBER_DATABASE / AMBER_ALLOW_SIGNUP / AMBER_LOGLEVEL / AMBER_DOMAIN set, the program will respect them and use over the values provided with the config file.


This app directly depends on flask, flask-sqlalchemy, flask-cors, and bcrypt.

requirements.txt is left only so that pipenv is not needed while building the app in Docker. Please use pipenv in development.

Running in Docker

The Dockerfile included with the project assumes that:

  1. You’re going to use either PostgreSQL or SQLite.
  2. You’re going to run it behind a reverse proxy such as nginx (and running the app without a reverse proxy won’t work because of the current uwsgi configuration).

If you have to/prefer to use MariaDB, etc, you’ll have to add the necessary Python packages to the Docker image by hand. See SQLAlchemy docs for details.


See LICENSE.txt.