offerflow (Xiangyahaian/offerflow)
Searching Database…
What is this?
OfferFlow is a local-first tracker for internship and campus job applications — it also connects to your inbox and uses AI to turn job emails into application records.
Is it a hosted service I sign up for, or something I run myself?
You run it yourself: a FastAPI server with a browser UI built on Jinja2 and vanilla JS/CSS, started locally or via Docker — there is no hosted version.
How do I get it running?
Run it with Python 3.10+ or Docker Compose. Copy env.example to .env first; the server listens on port 8001 by default.
What do I need for the AI email parsing to work?
Your own IMAP account and an AI model API key, entered on the Mailbox / AI Assistant page in the sidebar; a SECRETKEY in your .env encrypts those credentials.
Do I have to connect a mailbox, or is it useful without the AI part?
The tracker, dashboard and calendar work on their own; AI parsing is an extra you switch on later from the Mailbox / AI Assistant page once it has an IMAP account and API key.
Is it free to use?
Yes — it is MIT licensed, so you can use, modify and self-host it freely; there are no paid plans.
What does the AI actually do with the emails it finds?
It pulls application emails over IMAP, extracts the company, role, time and status, and automatically creates or updates the matching application record — no manual copy-pasting.
What can I track for each application?
Status transitions, priority, interview rounds and a countdown to each interview, plus drag-and-drop reordering and batch operations on the applications table.
Besides the applications table, what other views are there?
A dashboard showing total applications, pending items and an offer overview, plus a calendar view that gathers all written tests and interviews in one place.
What is it built with?
FastAPI with SQLAlchemy over SQLite on the backend, a Jinja2 frontend in vanilla JS and CSS, running on Python 3.10+ under Uvicorn.
What are similar projects?
ai-goofish-monitor, Resume-Matcher, Termix, agent-control, amane, outlook-auto-register, any-auto-register, Shadowbroker
Which topics is it in?
imap, drag-and-drop, job-search, ai-assistant, fastapi, sqlite, css, docker-compose, dashboard, local-first, server, self-hosted
