alfagok

Omdat Nederlanders ook alphaguess willen spelen :)

My own implementation of an alphaguess like game with custom word lists, tailored to be used with a Dutch source.

Using Alpine.js on the frontend and FastAPI as backend.

Environment variables

set -x WORD_LIST /path/to/alfagok_wordlist.txt
set -x START_DATE 2024-11-02
set -x DICTIONARY_LIST /path/to/dictionary.txt

In src/alfagok, with an active virtualenv with packages installed (uv pip sync requirements.txt), run:

fastapi dev main.py

Example configs

nginx

/etc/nginx/sites-enabled/alfagok.example.com.conf

server {
 listen [::]:443 ssl; # managed by Certbot
 listen 443 ssl; # managed by Certbot
 server_name alfagok.example.com;
 real_ip_header X-Forwarded-For;
 access_log /var/log/nginx/access_alfagok.example.com.log;
 error_log /var/log/nginx/error_alfagok.example.com.log warn;
 location / {
 proxy_pass http://127.0.0.1:8889;
 proxy_read_timeout 60;
 proxy_connect_timeout 60;
 proxy_redirect off;
 # Allow the use of websockets
 proxy_http_version 1.1;
 proxy_set_header Upgrade $http_upgrade;
 proxy_set_header Connection 'upgrade';
 proxy_set_header Host $host;
 proxy_cache_bypass $http_upgrade;
 }
 ssl_certificate /etc/letsencrypt/live/alfagok.example.com/fullchain.pem; # managed by Certbot
 ssl_certificate_key /etc/letsencrypt/live/alfagok.example.com/privkey.pem; # managed by Certbot
 include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
 ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

}
server {
 if ($host = alfagok.example.com) {
 return 301 https://$host$request_uri;
 } # managed by Certbot

 listen [::]:80;
 listen 80;
 server_name alfagok.example.com;
 return 404; # managed by Certbot
}

systemd unit file

/etc/systemd/system/alfagok.service

[Unit]
Description=Gunicorn Daemon for alfagok game FastAPI
After=network.target
[Service]
User=USERNAME (fill in!)
Group=USERGROUP (fill in!)
WorkingDirectory=/srv/www/alfagok.example.com/alfagok/src
Environment="START_DATE=2024年11月02日"
Environment="WORD_LIST=/srv/www_data/alfagok.example.com/wordlist.txt"
Environment="DICTIONARY_LIST=/srv/www_data/alfagok.example.com/dictionary.txt"
Environment="STATIC_DIR=/srv/www/alfagok.example.com/alfagok/src/alfagok/static"
Environment="TEMPLATE_DIR=/srv/www/alfagok.example.com/alfagok/src/alfagok/templates"
ExecStart=/srv/www/alfagok.example.com/venv/bin/gunicorn -c /srv/www/_webconfig/sites/alfagok.example.com/gunicorn_alfagok_conf.py alfagok.main:app
[Install]
WantedBy=multi-user.target

gunicorn config file

# gunicorn_conf.py
from multiprocessing import cpu_count
bind = "127.0.0.1:8889"
# Worker Options
#workers = cpu_count() + 1
workers = 1
worker_class = 'uvicorn.workers.UvicornWorker'
# Logging Options, dir should be writable for User in systemd unit file
loglevel = 'debug'
accesslog = '/var/log/alfagok/access_log'
errorlog = '/var/log/alfagok/error_log'