Quickstart: Python, plain functions

1. Install #

uv add signafaide                 # a uv project
poetry add signafaide             # a Poetry project
python3 -m venv .venv && .venv/bin/python -m pip install signafaide   # otherwise; add it to requirements.txt

2. Wrap the tools that act #

import signafaide

@signafaide.record
def approve_payout(claim_id: str, amount: float): ...

# or wrap existing functions without touching their definitions:
approve_payout, escalate = signafaide.wrap_tools([approve_payout, escalate])

# a decision that is not a tool call:
signafaide.note("routing", {"reason": "amount over limit"})

Every call of a wrapped tool writes a signed decision record before it runs and an outcome record after it (the result, or the error, which is raised again unchanged). Records are signed and chained in .signafaide/ on your machine, and nothing is sent until you opt in (step 4).

3. Verify #

Run the agent once, then:

signafaide verify             # or: uv run signafaide verify / .venv/bin/signafaide verify

One line per check, then a result line that says how many of the 12 checks passed, are pending and were not checked, for example PASS: 4 of 12 checks passed, 8 not checked (nothing co-signed yet) before anything is sent, and what still needs a witness (co-signature, public timestamp). A check that was not run is never counted as passed. See Verify for what each check means.

4. Send hashes to a witness (when you choose) #

signafaide init

creates a free sandbox (no account, email or card), saves SIGNAFAIDE_API_KEY to .env (and adds .env to .gitignore) and prints a link to claim it. Only salted hashes are sent, never inputs or outputs; records written before ship with their original times, if they are at most 7 days old. To keep the evidence in your environment, self-host the witness and set SIGNAFAIDE_URL.

Other quickstarts: Python, LangChain · Python, OpenAI Agents SDK · TypeScript, plain functions · TypeScript, LangChain · TypeScript, OpenAI Agents SDK · TypeScript, Vercel AI SDK.