What a pull reads can now be changed on a page instead of only the command line: try a search and see its first ten results before saving it, edit or remove one, follow a company's ATS board, switch any board or search on or off, and preview and apply a prune by region. Each row shows its open roles and the countries they are in. The page and `app companies`/`app searches` call the same functions in app/jobs/sources.py. Switching a target off closes its open roles, and the pull's settle closes them again if a batch in flight reopened them. Roles pulled before `country` existed are backfilled at startup. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
50 lines
3.7 KiB
Markdown
50 lines
3.7 KiB
Markdown
# roledesk
|
|
|
|
A job-search engine for one person. It reads the public job boards of the companies you follow (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee, Personio) and runs saved searches on boards that span companies (Jobindex, Adzuna), keeps every posting with when it was first seen and when it closed, scores the open roles for each of your search agents, and tracks the applications you make.
|
|
|
|
Built on the [boilerplate](../boilerplate): its job queue and scheduler (`pipeline/`), password (`auth/`) and deploy kit (`deploy/`), plus the plugin contract and tools from news (`desk/`). FastAPI, Jinja2, SQLite, `uv`, no build step.
|
|
|
|
## Quick start
|
|
|
|
```bash
|
|
uv sync --all-extras
|
|
uv run app companies seed # 186 companies from seed/companies.json, one board each
|
|
uv run app job pull # read every board and search, then extract, embed and score
|
|
uv run app serve # http://127.0.0.1:8790
|
|
```
|
|
|
|
`uv run app worker` drains the queue without the web app, and `uv run pytest` runs the app's tests and the copied modules' own. `config.yaml` is the committed default, with three starter agents and four Copenhagen searches on Jobindex; `config.example.yaml` documents every key.
|
|
|
|
## Searches and companies
|
|
|
|
The Sources tab does all of this; the same actions exist on the command line:
|
|
|
|
```bash
|
|
uv run app searches add jobindex "Copenhagen golang" --q "golang go-udvikler" --area 1
|
|
uv run app searches add adzuna "Berlin backend" --q backend --country de --where Berlin
|
|
uv run app searches list
|
|
uv run app companies prune --in DK,SE,NO,EU # lists; add --apply to unsubscribe
|
|
```
|
|
|
|
A Jobindex query is its own syntax: words are OR, `"a b"` is a phrase, `+word` is required; `--area 1` is Region Hovedstaden. An Adzuna search needs a free key from developer.adzuna.com in `ADZUNA_APP_ID` and `ADZUNA_APP_KEY`. `searches add` runs the search once and saves it only if it finds something. Switching a board or search off closes its open roles; the next pull after switching it back on reopens the ones it still lists. The `embeddings` extra is what `fit` needs, `agent` is for `extract` on a model, `passkeys` for the Account tab's passkeys.
|
|
|
|
## The tabs
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Roles** | open roles, newest or ordered by one agent's score, with filters, a Save button and each company's affinity |
|
|
| **Applications** | the saved roles and their status, each change recorded as an event |
|
|
| **Agents** | the search agents: intent, require and prefer gates, weights. Saving one rescores it |
|
|
| **Companies** | every company whose board is read, its open roles, and its affinity: mute, neutral, like, favourite |
|
|
| **Sources** | what a pull reads: saved searches (try, save, edit, remove), company boards (follow one, switch any on or off), and a prune of boards by region, with the countries each one's roles are in |
|
|
| **Jobs** | a button per job (`pull`, `extract`, `embed`, `score`) and what is running |
|
|
| **Schedules** | `pull` every 6h by default, editable in place |
|
|
| **Messages** | everything the server said that nobody has cleared |
|
|
| **Account** | the password, sessions and passkeys. Open on loopback, locked on anything else |
|
|
|
|
## Docs
|
|
|
|
- [`docs/decisions.md`](docs/decisions.md): what was decided for roledesk and why.
|
|
- [`desk/README.md`](desk/README.md), [`pipeline/README.md`](pipeline/README.md), [`auth/README.md`](auth/README.md), [`deploy/README.md`](deploy/README.md): the copied modules, where each comes from and how to refresh it.
|
|
- [`docs/hosting.md`](docs/hosting.md), [`docs/release.md`](docs/release.md), [`docs/server.md`](docs/server.md), [`docs/password-protection.md`](docs/password-protection.md), [`docs/llm-backends.md`](docs/llm-backends.md): the boilerplate's deployment docs.
|