Before: A blank rate becomes a plausible market assumption.
Missing inputs stay missing
The assistant asks for a dated source instead of filling the cell with a number that merely looks reasonable.
HINT for Financial Analysts
Your assistant builds models fast. HINT keeps every figure sourced.
HINT keeps inputs, formulas, dates, scenarios and checks in plain-text notes beside a financial model. Your assistant sees which assumptions may change and which figures require an approved source.
Where it helps
Three situations your team will recognize
Before: A downside case changes both assumptions and formulas.
Scenarios alter declared inputs only
Core calculation logic stays stable so scenario comparisons remain meaningful.
Before: A model balances because an error was hidden in a hard-coded value.
Checks fail visibly
Required reconciliations and tolerances travel with the output and cannot be smoothed over in commentary.
See it
A real model input from the demo
The Bluth Finance demo grounds a Banana Stand model input in SRC-1.
demo-bluth-finance/models/banana-stand/model.md.hint ↗
# read Approved source
../../sources/approved.md
# input banana-stand-1 {#financial_analyst_demo}
Approved input grounded in SRC-1.
# never Invented detailsWhat your assistant does next
It preserves the source and date, changes only inputs allowed by the scenario, and reports any failed model check.
What your AI assistant receives
<input name="banana-stand-1">
Approved input grounded in SRC-1.
</input>
<never name="Invented details">…</never>Your boundaries stay visible
What it will never do
- Invent a figure, rate, comparable or baseline.
- Change a formula when a scenario permits only input changes.
- Hide a failed check or unresolved reconciliation.
FAQ
Questions financial analysts ask
Is this investment advice?
No. HINT records model rules and sources; it does not recommend securities or financial decisions.
Can it update market data?
Only through sources and tools you explicitly provide. HINT itself does not fetch or invent current values.
Can it compare scenarios?
Yes. Scenarios can specify which declared inputs change while leaving formulas and checks fixed.
For your technical colleague
The vocabulary
A hintbook is a vocabulary for your profession—installed, not written by you.
model- Sets the purpose, owner and valuation date of a model.
input- Records a sourced and dated model input.
driver- Names an assumption that may vary in a scenario.
formula- Defines an explicit calculation from named inputs.
output- Names a result and how it should be interpreted.
scenario- Sets a coherent group of allowed input changes.
sensitivity- Varies one declared driver over a stated range.
check- Defines a reconciliation or tolerance that must pass.
Manual setup
Bootstrap is read-only: it prints instructions for the assistant. The assistant performs the installation.
npm install -g @openhint/cli
hint config
hint add @openhint/hintbook-financial-analyst
hint apply
hint verify models/banana-stand/model.md
hint emit models/banana-stand/model.md