Repository navigation
Expand file tree
/
Copy pathtalanton.example.toml
More file actions
170 lines (147 loc) · 7.28 KB
/
Copy pathtalanton.example.toml
File metadata and controls
170 lines (147 loc) · 7.28 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
# Copy into your hiring repository as talanton.toml.
#
# Settings go here and are committed. Secrets never do — every password comes
# from the environment, so this file is safe to review in a pull request, which
# is the point.
[company]
name = "Example Co"
# Reaches the agent's own instructions. One factual clause, not marketing.
description = "a small engineering company in Zürich"
[store]
# The working area. openings/ lives here, and relative location paths below
# resolve against it.
path = "."
# ---------------------------------------------------------------------------
# The two locations the core runs on. Everything else is optional.
# ---------------------------------------------------------------------------
# Where CVs are read from. Put them there however you like: drop them in the
# folder, or let `talanton fetch` pull them out of a mailbox.
[storage.cvs]
backend = "local" # local | gdrive | gcs
path = "cvs"
# backend = "gdrive"
# folder_id = "1AbC..." # from: talanton drive-folder "hr/recruiting"
# folder = "hr/recruiting" # or give the path and resolve it at runtime
# backend = "gcs"
# bucket = "example-hiring" # pin the bucket's region when you create it
# prefix = "cvs"
# Where assessments are written. Can be a different backend from the CVs.
[storage.assessments]
backend = "local"
path = "assessments"
# Optional. Where `talanton publish <role>` writes an opening's board copy and
# its rubric, so whoever reads an assessment can see the bar it was scored
# against without opening this repository. Leave the section out entirely and
# `publish` is unavailable and `check` says nothing about it.
#
# Note this is NOT `openings/`, which holds the position files themselves. The
# published copy is derived; the YAML stays the source of truth, and nothing
# ever reads the published copy back.
# [storage.openings]
# backend = "local"
# path = "published"
# backend = "gdrive"
# folder_id = "1AbC..." # from: talanton drive-folder "hr/recruiting"
# ---------------------------------------------------------------------------
# Optional: the two mail adapters. They are separate accounts on purpose.
# ---------------------------------------------------------------------------
# Reading the apply mailbox. Password from $TALANTON_INBOUND_PASSWORD.
# Nothing that holds these credentials can send — `talanton.inbound` has no
# SMTP path and does not import the module that does. Leave `user` empty and
# `fetch` is simply unavailable; everything else still works.
[mail.inbound]
user = "apply@example.com"
imap_server = "imap.gmail.com"
imap_port = 993
# Ceilings, so a flooded mailbox is a bounded run rather than a bill. What is
# left over waits for the next run; an oversized attachment is skipped and the
# filename logged, so somebody can ask for a smaller one.
max_emails_per_run = 25
max_attachment_mb = 20
# Sending the shortlist. A DIFFERENT account, with no access to the apply
# mailbox, so if it were ever misused it could not read a CV.
# Password from $TALANTON_OUTBOUND_PASSWORD.
[mail.outbound]
user = "hiring-bot@example.com"
smtp_server = "smtp.gmail.com"
smtp_port = 465
# A reply to the shortlist should land somewhere a person reads. Defaults to
# the apply mailbox above.
# reply_to = "people@example.com"
# The shortlist goes to these addresses and nowhere else. It carries candidate
# ids and CV links, never names — who may learn an identity is decided by who
# can open the CV.
operators = ["hiring@example.com"]
# The only domains any outbound mail may reach. Empty means unrestricted.
allow_domains = ["example.com"]
# Log mail instead of sending it. Turn off once you trust it.
dry_run = true
[schedule]
# Nothing here executes this — whatever fires `talanton cycle` owns that.
cron = "0 8,16 * * 1-5"
idle_timeout_seconds = 900
[screening]
# Where the model is served. Named here rather than left to an ambient gcloud
# default — running a screening against the wrong project is exactly the
# mistake ambient defaults cause. An exported env var still wins over this.
project = "your-project"
# `global` routes to wherever the model is served. Verified 2026-09-07: no
# Gemini model is served from europe-west6, europe-west4 or europe-west1 —
# a regional value there fails with 404, it does not fall back.
location = "global"
# The identity to act as, when the one talanton finds cannot hold Drive scopes.
# Leave it unset on a laptop that already impersonates the account. Set it for a
# Cloud Run job: the metadata server there returns a cloud-platform token
# whatever is asked of it, and the Drive API rejects cloud-platform, which
# surfaces as a 403 that looks like a permissions problem and is not one.
# Needs roles/iam.serviceAccountTokenCreator on the account, held by the account
# itself. Still no key file.
# service_account = "talanton@your-project.iam.gserviceaccount.com"
# A stable model, not a preview — a screening standard should not change under
# you between runs. `gemini-2.5-pro` if you want pro tier; an @-versioned
# Anthropic id such as claude-opus-4-5@20251101 also works — install the
# [anthropic] extra for that, ADK reaches for the SDK to serve it. Not every
# model is served in every region.
model = "gemini-3.8-flash"
max_output_tokens = 8000
# ---------------------------------------------------------------------------
# Whether an application may reach the pipeline by any route other than the
# apply mailbox.
#
# Off by default, and that is the point. The reason to have one intake path is
# that every candidate is then logged, timed and screened the same way; a
# second route is a decision somebody makes deliberately, not one a command
# makes for them.
#
# With it on, `talanton import <dir> --opening <n> --source <name>` brings in a
# folder of applications and records that they came in that way. Without it,
# the same files have to be forwarded into the apply mailbox by a person —
# which works, and stores the forward's sender and date instead of the
# application's.
# ---------------------------------------------------------------------------
# [intake]
# import = true
# ---------------------------------------------------------------------------
# What the shortlist mail carries.
#
# By default it carries candidate ids and CV links and never a name, and a
# summary that names somebody is refused rather than quietly sent. No law
# requires that. The reason is that email has no access control: a name in an
# inbox is forwarded, archived and outside the folder membership that governs
# the CV itself, and it cannot be taken back. A link leaves identity behind a
# permission somebody can revoke.
#
# Set this where readable mail is worth more than that, and write down that
# you decided it. `check` says so on every run once it is on. Note that
# allow_domains matches a domain rather than an address, so a typo at a
# permitted domain is a real recipient — which matters more with names in the
# body than with links nobody can open.
# ---------------------------------------------------------------------------
# [shortlist]
# names = true
#
# How many candidates the mail carries: the top N of the shortlistable pool by
# score, after the knockouts and the floor. The footer says what places N+1
# and N+2 scored, so a tie at the cut is visible. Unset, the agent decides how
# many are worth your time, and the number changes from run to run.
# size = 20