All plugins

docket

Quotes for trades businesses (plumbers, electricians, HVAC): describe a job in words or a voice note and Docket prices every line from the owner's own price book with a deterministic engine (the model only picks item codes; it never writes a number). The owner approves with one tap on Telegram, Slack, Discord or Desktop, the customer accepts on a quote page, and the owner books the day and closes out with an invoice. Includes a plain-words price book editor with preview before save, PDF quotes and invoices, follow-ups, a run sheet and a Desktop Jobs board. Disclosure — Docket stores customers, quotes and invoices in a local SQLite file under plugin-data/docket and starts a local HTTP server for the customer accept page (127.0.0.1:8787 by default, in a background thread of the gateway, one server for all profiles the gateway serves); it reads a price list file only when the owner names one; job descriptions and unreadable price lists go to the model configured in Hermes; the pre_transcription hook adds price book item names to the speech-to-text prompt; sending a quote and saving price changes ask the owner first, and both, plus closing a job, are blocked in scheduled runs; with Obol installed, close-out returns a prepared draft that the agent creates through obol_create_invoice, so Obol's own approval applies (Docket never calls Obol itself). No outbound network calls of its own, no shell commands, no credentials, no telemetry, no email sending.

MKemplerToolsv0.1.1Updated 7 days ago

About

Quotes for trades businesses (plumbers, electricians, HVAC): describe a job in words or a voice note and Docket prices every line from the owner's own price book with a deterministic engine (the model only picks item codes; it never writes a number). The owner approves with one tap on Telegram, Slack, Discord or Desktop, the customer accepts on a quote page, and the owner books the day and closes out with an invoice. Includes a plain-words price book editor with preview before save, PDF quotes and invoices, follow-ups, a run sheet and a Desktop Jobs board. Disclosure — Docket stores customers, quotes and invoices in a local SQLite file under plugin-data/docket and starts a local HTTP server for the customer accept page (127.0.0.1:8787 by default, in a background thread of the gateway, one server for all profiles the gateway serves); it reads a price list file only when the owner names one; job descriptions and unreadable price lists go to the model configured in Hermes; the pre_transcription hook adds price book item names to the speech-to-text prompt; sending a quote and saving price changes ask the owner first, and both, plus closing a job, are blocked in scheduled runs; with Obol installed, close-out returns a prepared draft that the agent creates through obol_create_invoice, so Obol's own approval applies (Docket never calls Obol itself). No outbound network calls of its own, no shell commands, no credentials, no telemetry, no email sending.

https://github.com/user-attachments/assets/cc887d2c-c382-4345-8119-d88323cc7c8e


Docket is a Hermes Agent plugin for plumbers, electricians, handymen and anyone who quotes jobs from a price list. Describe the job the way you'd say it in the van, typed or as a voice note. The model only turns your words into price-book items; code prices every line, so the number on the quote is always the one your price book says.

At a glance

Measured, not claimed: with the same local model, Docket quotes 19 / 20 held-out jobs exactly; the model alone, given the whole price book, gets 3 / 20. See how →

Contents


Try it in two minutes (no accounts)

Docket ships a fictional demo company, Copperline Plumbing & Drain, so you can try the whole loop with no signups, keys or messaging apps. Everything runs on your machine.

# answer "y" when Hermes offers to install Docket's Python libraries (reportlab, Pillow, ruamel.yaml)
hermes plugins install MKempler/docket --enable
hermes docket demo        # six customers, quotes in every state

Then start a new Hermes session (new plugins' tools load in the next session) and run:

/quote Dana Henderson, 14 Maple St 62707, swap the 50 gallon gas water heater, permit and haul away
/quote send Q-1007            # prints the customer's accept link: open it, click Accept
/jobs                         # Q-1007 is now Accepted
/blueprint                    # Docket's three automations
You should seeExample
A quote for $1,972.36 with every line's pricing ruleReplace 50-gal gas water heater: 3 h × $135.00 = $405.00; materials $1,222.50 …
A customer page with Accept quoteserved locally at http://127.0.0.1:8787/q/…
/jobs moving the job to Acceptedthen /quote book, /quote done, /quote paid

[!TIP]
In Hermes Desktop, open Capabilities → Plugins and switch on Docket, then run hermes gateway restart once so its backend loads. You get Jobs and Price book in the sidebar. Desktop plugins ship switched off by Hermes's design.


How it works

flowchart LR
    A["Say or type<br/>the job"] --> B["Model:<br/>words → codes"]
    B --> C["Engine:<br/>exact prices"]
    C --> D["You tap<br/>Send"]
    D --> E["Customer<br/>accepts"]
    E --> F["One tap<br/>to book"]
    F --> G["Invoice"]
    style C fill:#2a78d6,color:#fff,stroke:#2a78d6
    style D fill:#1baf7a,color:#fff,stroke:#1baf7a

Five rules drive the design:

  1. The model never produces a number. It only maps words to price-book codes and quantities, through a schema with no money fields. Code does every calculation in exact decimals, rounded once per line.
  2. Nothing is guessed. Work the price book can't price becomes a needs-price line, and a quote with one can't be sent. Lookalike jobs are caught too: "tankless water heater" is not the 50-gal gas swap.
  3. Nothing reaches a customer without your tap. Buttons send directly with no model turn. If the agent tries to send, Hermes asks you first, and scheduled runs are blocked from sending.
  4. Every send is once and versioned. A double tap sends once; revising a quote makes v2 and voids v1's customer link.
  5. Code checks what code can read. ZIP codes, weekend / after-hours / emergency, membership and stated labor hours are read from your words by code, whatever the model says.

Why a plugin and not a prompt

A prompt can describe a price book. It can't guarantee the arithmetic. We measured it on 60 messy, real-world job descriptions, with the same local model both ways:

Original 40 jobsHeld-out 20 jobs (never tuned on)
Bare model, given the full price book and every pricing rule8 / 403 / 20
Docket's built-in parser, no model at all27 / 4016 / 20
Docket (same model, words → codes, code prices)37 / 4019 / 20

The bare model was off by hundreds of dollars, and quoted a confident $1,815.74 for a water heater at a ZIP code the price book doesn't cover. All 4 of Docket's misses were safe: the total was right, but Docket flagged a line for you to check before sending.

  • Scoring: a job counts only if the total is exact to the cent, or the answer correctly flags work the price book can't price.
  • Model: Qwen 3.5 9B running locally in Ollama, thinking off. Bigger cloud models do better on their own, but the point stands: arithmetic belongs in code.
  • Held-out set: 20 jobs written after the first run and never used for tuning.
  • Reproduce: python evals/run_eval.py (any OpenAI-compatible endpoint), then python evals/make_chart.py redraws the chart from the result files. The parser row was re-scored with --parser-only after a fix to how it reads counts like "reset 2 toilets"; that file is in evals/results/ too. The job sets with hand-written ground truth and every raw result file are in evals/.

Quote from a voice note

Standing in a basement with wet hands? Hold the mic in Telegram and say the job:

"Dana Henderson, fourteen Maple Street, six two seven oh seven. Swap the fifty gallon gas water heater, permit, and haul away the old one."

Hermes echoes what it heard, and the priced quote card follows: $1,972.36, the same as typing it. Docket adds three things to Hermes's built-in transcription:

  • It teaches the recognizer your trade. A pre_transcription hook hands Whisper your own price book's words (PEX, P-trap, angle stop, expansion tank and the names you use for jobs), so they come out spelled the way the price book spells them. It updates itself when you change your prices.
  • It reads numbers the way people say them. "six two seven oh seven", a transcript's "627-07" and "an hour and a half" become 62707 and 1.5 hours before anything is priced.
  • It catches misheard names. If Whisper hears "Denahenderson" at a ZIP where you already have a Dana Henderson, the quote goes to Dana (with a note saying so). It never matches across ZIPs.

Docket still prices only what the transcript names. A word Whisper drops is a line missing from the card you check before sending, never a guessed one.

Measured. Every job spoken aloud by three macOS voices, transcribed with Hermes's own local Whisper settings, then quoted. The voice set is 20 jobs written the way people talk and committed before any voice results existed, never tuned on:

Voice held-out set (20 jobs)Whisper base (Hermes default)Whisper small.en
Plain transcription15 / 2016 / 20
With Docket's vocabulary hint17 / 2018 / 20

Of the 3 misses with Whisper base, two were safe (a dropped ZIP or a misheard word made Docket flag the quote instead of guessing); one lost a spoken "extra hour and a half of labor", a line missing from the card you check before sending. Synthetic voices are cleaner than a real one in a noisy basement, so read these as the pipeline's ceiling. On a development set, the vocabulary hint alone lifted Docket from 12/20 to 16/20, and the spoken-number handling took it to 19/20. Reproduce: python evals/run_voice_eval.py --jobs jobs_voice20.yaml --whisper base (macOS, for say).

Setup: voice notes need Hermes's local Whisper: hermes pm install --extra stt-whisper, then restart the gateway. For better accuracy, set stt.local.model: small.en in config.yaml.


A tour

Hermes Desktop: the Jobs board

A live pipeline: Draft → Sent → Accepted → Booked → In progress → Done. It updates the moment a customer accepts or you tap a button on your phone. Click a card for every line, its pricing rule, the full history, the customer link and the next action.

The board, with open-quote value in the status bar:

Inline quote card. Ask the agent for a quote in a Desktop chat and it shows up as a live card with a Send button, which updates itself when the quote is sent:

Telegram, Slack and Discord

Run /docket setup once in your chat with Hermes (!docket setup on Slack). From then on:

  • Quote cards arrive with ✅ Send · ✏️ Edit · 🗑 Discard. After sending, the card redraws with a SENT badge.
  • A message ready for the customer follows as its own chat message ("Hi Dana, here's your quote from Copperline… $1,972.36. See every line and accept it here: …"). Long-press it and forward it by text, WhatsApp or email. In Desktop it's copied to your clipboard when you press Send, and shown on the quote with a Copy button.
  • Customer updates: "👀 Dana opened Q-1007", then "✅ Dana accepted. Book it: [Sat Nov 7] [Mon Nov 9] [Pick a day]". Sundays are skipped.
  • Only you can press Docket's buttons, even in a group chat.

Settings, in Hermes's own Settings screen

Business name, phone, email and license number, how long quotes stay valid, invoice due days, payment terms, the public link for customers and when to follow up all live in Settings → Plugins → docket. Nothing to edit by hand.

Quotes and invoices your customers receive

Close-out and invoicing

/quote done Q-1007 plus 1 hour labor finishes the job and makes INV-1001, priced by the same engine, extra work included. The invoice PDF and email land in Docket's outbox, ready for you to send. Docket stops where invoicing starts:

  • Obol installed and the customer has an email → Docket also prepares the invoice as an Obol draft, but never sends it to Obol itself. Your agent creates it with Obol's own obol_create_invoice tool when you ask ("send invoice INV-1001 to Obol"), so Obol's own approval prompt, risk checks and block on scheduled runs apply.
  • Extra work that can't be priced blocks the invoice instead of silently disappearing.
  • Scheduled runs can't close jobs, and a paid invoice is never offered to Obol.

Your price book

Everything Docket quotes comes from one YAML file you own. You never have to open it.

Change it in your own words

Type a change, paste a whole price list, or load a CSV from your supplier or old spreadsheet. Docket shows exactly what would change and saves only when you confirm:

/pricebook add labor 145/hr, 3/4" PEX $2.20/ft, Sump pump $289 each, Backflow test $95 flat
/pricebook add TOILET-REPLACE 2 hours
/pricebook import ~/Downloads/supplier-prices.csv
/pricebook undo
  • No invented prices. Every price must appear, digit for digit, in what you typed. A model reads only the chatty lines a plain reader can't ("toilets are 350 flat and 3/4 pex is 2.20 a foot"), and any number it returns that you didn't write is refused and reported.
  • No guesses. A line that could mean several items is left unchanged, listing the candidates, as in water heater $1200 above.
  • Your file stays yours. Edits change only the affected lines; your comments and layout are kept. Every save is re-validated and backed up, so /pricebook undo puts it back.
  • Same flow everywhere. A preview card with ✅ Save / Cancel on Telegram, Slack and Discord; the Price book page in Desktop; or tell the agent ("raise my labor rate to $150"), whose save goes through Hermes's approval prompt listing the exact changes.
  • Starting your own: /pricebook new Rivera Plumbing, labor 120/hr, tax 7%, then add items.

If you edit the file by hand, run /pricebook validate afterwards; mistakes are reported with the line number.

labor:
  rate: "135.00"           # per hour
  minimum_hours: "1.0"
multipliers:               # labor only; the highest flagged one wins
  after_hours: "1.5"
  weekend: "1.25"
  emergency: "2.0"
tax: { name: Sales tax, rate: "0.0825", applies_to: [materials] }

assemblies:                # jobs: labor + parts per unit
  WH50-REPLACE:
    name: Replace 50-gal gas water heater
    aliases: ["water heater", "heater swap"]          # how you actually say it
    exclude: ["tankless", "electric", "heat pump"]    # "not this job": becomes needs-price
    labor_hours: "3.0"
    materials: [{ code: WH50G, qty: "1" }, { code: WHKIT, qty: "1" }, { code: EXPTANK, qty: "1" }]

fees:
  HAULAWAY:
    name: Haul away old fixture
    amount: "35.00"
    limit_to: [WH50-REPLACE, TOILET-REPLACE, DISPOSAL-INSTALL, FAUCET-KITCHEN]   # one per replaced fixture

Also supported: travel zones by ZIP, member discounts (labor only), materials sold on their own, and fittings rounded up to whole units. See the full demo book in demo_data/pricebook.yaml.


Commands, tools and automations

Automations (in /blueprint, the Desktop Cron page and the dashboard):

BlueprintWhenWhat you get
docket:quote-followupsweekday morningsQuotes unanswered for N+ days, each with a ready-to-send nudge. Never sends.
docket:run-sheeteveningsTomorrow's jobs, addresses and the materials to load on the truck
docket:weekly-pipelineMondaysOpen quote value, jobs won this week, win rate

Agent tools: docket_quote, docket_send_quote (asks you first; blocked under cron), docket_pricebook_edit (preview only), docket_pricebook_save (asks you first; blocked under cron), docket_price_preview, docket_jobs, docket_close_job (blocked under cron; never calls Obol), docket_followups, docket_run_sheet, docket_pipeline.

CLI: hermes docket demo [--reset] and hermes docket serve.


Setup by surface

SurfaceStatusHow
CLIVerifiedWorks out of the box
Hermes Desktop / WebappVerifiedCapabilities → Plugins → switch Docket on, then restart the gateway once so the board's backend loads
TelegramVerified livehermes gateway setup → Telegram, then send /docket setup to your bot. Voice notes: hermes pm install --extra stt-whisper
SlackVerified livehermes gateway setup → Slack, then !docket setup. Use !quote, !jobs: Slack caps apps at 50 slash commands, and Hermes uses them all
DiscordVerified livehermes gateway setup → Discord, add the bot to a server you're in (Discord only lets bots DM people they share a server with), then /docket setup
Other platformsSupportedSlash commands and Hermes's own choice prompts

Customer links. The accept page runs on your machine (127.0.0.1:8787, or the next free port). To let real customers reach it, put it behind a tunnel you control and set Public link for customers in Settings → Plugins → docket (or run /docket link https://your-tunnel.example).

Model. Docket registers its own model slot, Docket job intake, with thinking off. Point it at a fast, cheap model in Hermes's Models settings if you like. Small local models work; if the model fails, Docket falls back to its built-in parser.


Safety and disclosures

Stored dataCustomers, quotes, events and invoices in a local SQLite file in each Hermes profile's plugin-data/docket/. It survives updates and reinstalls.
Model callsJob descriptions go to the model you configured in Hermes, to map them to codes. Price lists it can't read plainly go to the same model. Prices never come from the model: an imported price must appear in your own words.
Voice notesTranscribed by Hermes's speech-to-text (local Whisper by default). Docket's pre_transcription hook adds your price book's item names and aliases to the transcription prompt; if you configured a cloud speech provider, that prompt goes to it with the audio.
NetworkA local HTTP server for the customer accept page (loopback by default), in a background thread: the gateway starts it when a messaging platform connects, otherwise it starts the first time a customer link is made. Messages go only to your registered chat, through your bots. No telemetry.
EmailDocket does not send email or texts. It writes the customer email and PDF to the outbox, and hands you a ready-to-forward message; you choose how it reaches the customer. It warns you when a customer link would only open on your own computer.
ApprovalsA pre_tool_call gate asks before the agent sends a quote or saves a price book change (listing the exact changes), and blocks both, and closing a job, from scheduled runs. A pre_llm_call hook adds one line pointing the model at Docket's tools, only on messages about quoting, sending a quote, your price book, your jobs or an invoice.
PaymentsNone. Invoices are kept as PDFs. With Obol installed, Docket prepares an Obol draft that your agent creates through Obol's own tool, so Obol's approval applies; Docket never calls Obol itself.
AutomationsBlueprint jobs you schedule keep running after Docket is removed, until you delete them.
ProfilesEach Hermes profile has its own Docket data: quotes, price book and customer links (/p/<profile>/q/… for a named profile on a gateway that serves several). Quote-card buttons on Telegram, Slack and Discord are wired once per gateway, not per profile, so on a gateway that serves several profiles, use the slash commands or Desktop for the named ones.

Development

git clone https://github.com/MKempler/docket && cd docket
uv venv .venv && uv pip install --python .venv/bin/python -r requirements-dev.txt
.venv/bin/python -m pytest -q                                     # 161 tests; CI runs them on Python 3.11–3.14
hermes plugins doctor docket --ci && hermes plugins validate docket --install-deps
AreaFiles
Pricingpricebook.py (load, validate, line numbers) · pricing.py (exact engine) · money.py
Evalsevals/run_eval.py (typed) · evals/run_voice_eval.py (spoken) · evals/make_chart.py · job sets and every raw result
Words → codesintake.py (model path with guards, plus the deterministic parser) · spoken.py (spoken numbers, split ZIPs) · hints.py
Voicevoice.py (price-book vocabulary for Hermes's speech-to-text)
Price-book editspbedit.py (read lists and CSVs, plan, patch in place, save, undo) · settings.py (Hermes Settings form)
Ledgerstore.py (versioned quotes, state machine, events) · links.py (signed, expiring links)
Flowservice.py · invoices.py · reports.py · demo.py
Surfacescommands.py · owner.py + channels.py (Telegram / Slack / Discord) · accept_server.py · dashboard/plugin_api.py · desktop/plugin.js
Documentsrender.py (quote and invoice PDFs, owner card) · outbox.py

README from the reviewed commit 3bba998; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section