Downwork

An automated job tracker that scrapes Upwork and sends Telegram pings when something matches. Django, Celery, and uv power it.

Features

• Background scraping via Celery runs asynchronously
• Scheduled periodic checks through Celery Beat
• Instant Telegram alerts for matching jobs
• Commands made simple with just

Setup

1. Environment

cp .env.dist .env Copy the template env file and fill in your secrets.

2. Dependencies

just install Pulls everything using uv.

3. Database

just makemigrations just migrate

Running Production

Open three shells:

• Django server:

  just runprod

• Worker:

  just celery

• Scheduler (Beat):

  just beat

just Commands

• just — migrations + dev server
• just install — sync deps via uv
• just superuser — add admin user
• just format — lint and format with Ruff
• just test — run Django tests
• just shell — interactive shell