Document processing service.
  • Python 58.7%
  • HTML 25%
  • TypeScript 14.3%
  • Dockerfile 1.1%
  • Mako 0.8%
Find a file
2026-04-02 02:52:59 +01:00
.zed ZED editor settings update. 2026-03-18 14:48:36 +00:00
alembic ALEMBIC MIGRATION -- add status field with default values to files table. 2026-03-28 04:11:51 +00:00
blueprints Rename import, follow naming conventions. 2026-04-02 02:50:32 +01:00
docs Add doc. 2026-01-24 00:58:13 +00:00
modules Remove debug print statements. Add image fetch methods to fetch, load and resize image. 2026-04-02 02:43:56 +01:00
static Add logic to load image to card viewer. 2026-04-02 02:45:21 +01:00
templates Add new macros. 2026-04-02 02:49:13 +01:00
.dockerignore Compose the entire application for Docker usage. 2026-03-22 20:24:55 +01:00
.env.example Include '.env' sample file for later dev use. 2026-01-02 06:05:10 +00:00
.gitignore Ignore img directory. 2026-04-02 02:52:59 +01:00
alembic.ini update connection URL for env var usage 2025-12-31 07:20:37 +00:00
app.py Update config object naming -> AppConfigBase. 2026-03-25 05:10:55 +00:00
docker-compose.yaml Add volume to worker and new environment variable to web. 2026-03-25 05:11:30 +00:00
Dockerfile Update celery_worker name and location. 2026-03-25 05:09:29 +00:00
package-lock.json Updated packages. 2026-03-07 20:34:08 +01:00
package.json Remove the --content flag, since its no longer supported. 2026-04-02 02:49:53 +01:00
README.md Update stack info. 2026-03-04 05:40:23 +01:00
requirements.txt Include Pillow library, version pinned. 2026-04-02 02:49:29 +01:00
ROADMAP.md Update ROADMAP and TODO. 2026-01-15 07:45:02 +00:00
TODO.md TODO. 2026-03-25 05:09:49 +00:00
tsconfig.json Remove watching flags for compilers. 2026-03-18 14:44:44 +00:00

Installation

The installation process is very straighforward.

Create virtual environment.

uv venv --seed

Install requirements.txt.

pip install -r requirements.txt

Copy dotenv and populate with correct credentials.

cp .env.example .env

Test connection with DATABASE.

alembic check

... if you see something like:

INFO  [alembic.runtime.migration] Context impl PostgresqlImpl.
INFO  [alembic.runtime.migration] Will assume transactional DDL.

... things went well, you can even do alembic history to see versions. If you don't see this output, something's not right. DEBUG!

👨🏼‍💻 - If you get hba_file related error, refer to docs.

Stack

Backend

  • Gunicorn;
  • Flask;
  • Jinja2;
  • Python;
  • alembic;
  • PostgreSQL;
  • argon2;
  • Tailscale;
  • TypeScript;
  • NodeJS;
  • Redis Queue; (25 Jan, 2026)

Frontend

  • tailwindcss;
  • tailwind templates;