Files
jobboard/config.example.yaml
T
WolfandClaude Fable 5.1 a0772519b3 Per-agent ranking: votes, affinity and a taste term; settings are three sub-tabs
Votes on roles and company affinity move to role_votes and agent_companies,
one row per search agent, so two agents rank the same roles differently. The
score gains taste, the cosine to mean(liked) - mean(passed) of the agent's
votes, as newsdesk ranks articles. The API takes agent on roles, votes and
companies and falls back to the default agent, the enabled one with the
lowest id.

Settings become Search agents (a list again, with New and Delete), Sources
(job boards, company boards and runs with the message log, one section per
plugin) and Account. Old paths answer 301 to their section.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-28 12:53:41 +02:00

115 lines
5.0 KiB
YAML

# roledesk configuration. The app reads --config, else $APP_CONFIG, else
# config.yaml beside the checkout (committed: these defaults plus the starter
# agents). Every value below is the default, so a copy with nothing changed
# behaves exactly like no file at all. An unknown key is an error, not a
# shrug; see app/config.py.
server:
# 0.0.0.0 in a container -- the proxy is what is in front of it.
host: 127.0.0.1
port: 8790
# The SQLite file: roles, companies, subscriptions, applications, agents and
# scores, the job queue and its schedules, the notice log, and auth's
# sessions. Not shared with newsdesk.
database: roledesk.db
# What a clock on screen means, and what `daily at 06:00` is 06:00 in.
timezone: Europe/Berlin
log_level: INFO
# One password on a public hostname; see auth/README.md and
# docs/password-protection.md. The password is never in this file.
auth:
enabled: auto # auto: open on loopback, locked on anything else
session_days: 30
secure_cookie: auto # always, behind a TLS-terminating proxy
rp_id: "" # roledesk.example.com -- passkeys are bound to it
rp_name: app # what the authenticator shows you
origin: "" # https://roledesk.example.com
password_env: APP_PASSWORD
cookie: app_session # unique per app sharing a hostname
# Any .py file in these directories defining a desk `Source` subclass is a
# plugin. A plugin imports `desk` only.
plugin_paths:
- plugins
# Workers per resource class. `http` is wide because a fetch is mostly waiting.
workers:
llm: 4
http: 8
cpu: 1
# Who answers when a job needs a model. See desk/tools/agent.py; needs the
# `agent` extra.
agent:
backend: auto # auto | api | claude_code | off
# Title and description in, gate columns out (app/jobs/extract.py). Off by
# default: on the API backend every batch of 20 roles is a paid call.
extract:
enabled: false
model: claude-haiku-4-5-20251001
# About 60 words on a role: what it is, the stack, where, the pay if stated
# (app/jobs/summarise.py). Off by default. On, each pull summarises the best
# per_agent roles of every enabled agent that have none yet, so the cost stays
# bounded however many roles are open. The Summarise button on a role's page
# asks for that one role either way.
summarise:
enabled: false
model: claude-haiku-4-5-20251001
per_agent: 30
# A role and each agent's intent as vectors, for the fit term of a score
# (app/jobs/embed.py). Needs the `embeddings` extra; without it `embed` posts
# a notice and scores leave fit out. Changing the model re-embeds.
embed:
model: sentence-transformers/all-MiniLM-L6-v2
per_run: 50000
# One block per plugin, keyed by the plugin's name. The ats and search plugins
# read their boards and searches from the subscriptions table, so they need
# none, except the key an adzuna search needs (or ADZUNA_APP_ID and
# ADZUNA_APP_KEY in the environment, which keeps it out of this file).
sources: {}
# search:
# adzuna: {app_id: "...", app_key: "..."}
# Starter search agents, imported once into an empty `agents` table. Each gate
# is {field, values, mode: require|prefer, weight}; fields are place, country,
# remote, seniority, function, salary_min, currency, permit, languages and
# company. weights default to {fit: 0.6, recency: 0.2, affinity: 0.2, taste:
# 0.2}; taste is how close a role is to the ones the agent liked minus the
# ones it passed. A country is an ISO code, filled from the board's location
# line; EU is a role open anywhere in Europe.
# The Search agents sub-tab lists and edits them; the order menu on Roles
# picks one by name. Two more, beside the starter in config.yaml:
agents: []
# - name: Remote from Europe
# intent: >-
# Staff or lead engineer role, fully remote from Europe. Platform and
# infrastructure work, distributed systems, developer tooling, technical
# leadership across teams.
# gates:
# - {field: remote, values: [remote], mode: require}
# - {field: country, values: [AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT,
# LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, IS, LI, NO,
# GB, CH, EU], mode: require}
# - name: Europe hybrid
# intent: >-
# Senior backend or platform engineer in a European tech hub, hybrid or
# remote-first. Python and Go, distributed systems, cloud infrastructure.
# gates:
# - {field: country, values: [AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT,
# LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE, IS, LI, NO,
# GB, CH, EU], mode: require}
# - {field: remote, values: [hybrid, remote], mode: prefer, weight: 0.05}
# Starter searches, imported once while there are no `search` subscriptions.
# provider is jobindex (Denmark, no key: q, area, pages) or adzuna (the UK and
# most of the EU, a free key: q, country, where, pages). See plugins/search.py.
searches: []