Small Python service that reads your this-month coding time from Wakapi and updates your GitHub profile bio on a schedule (every 15 minutes).

The bio uses a short duration string plus the current calendar month, for example: ⚡2h 30m coding this March 🚀 (exact format is defined in main.py).

This is a personal fork of wakapi-github for my own modifications.
Not intended for upstream PRs.

• Python or Docker
• A Wakapi account (self-hosted or wakapi.dev) and API key
• A GitHub personal access token with the **user** scope (to update your profile)

Create a .env file in the project root or export these in your shell:

The app uses python-dotenv to load .env when you run it locally.

python -m venv .venv
# Windows:
.\.venv\Scripts\activate

# macOS/Linux:
# source .venv/bin/activate

pip install -r requirements.txt
python main.py

From the repo root (uses .env automatically):

docker compose up --build -d

docker-compose.yml builds the image from this directory and passes the three variables into the container.

More Docker-oriented notes: README.Docker.md.

The .vscode folder is committed on purpose so you can debug in a container with a consistent setup:

1. Install Docker and the Docker VS Code extension.
2. Open this folder in VS Code.
3. Run and Debug → choose Docker: Python — General → F5.

Secrets: docker compose is the most straightforward way to run with a .env file. The stock Docker launch task builds from Dockerfile only; if variables are missing in the container, run via Compose or extend tasks.json / launch to pass the same env as docker-compose.yml.