Skip to content

solvi guide

This guide walks through the whole API. Where a question needs judgement, a model proposes and solvi's checks decide; the model is whichever you have — an LLM through solvi.llm, a decision service, or a local checkpoint such as solvi-base for offline or cheap cases (see the model proposes). For a two-minute overview, see the README; for advice drawn from building on solvi, see best practices. Every measured number in this guide names its source: a script in benchmarks/ or an example, which you can re-run from this repository, or the model card of a published model (solvi-base, solvi-large, solvi-large-long, extract-base, extract-receipts).

Contents:

  1. Concepts
  2. Installation
  3. The catalog
  4. Questions and answer types
  5. Types, questions and model decisions
  6. Asking: System and Response
  7. How the strategist plans a flow
  8. Questions without a rule: fit, learn_rule, teach
  9. Confidence, calibration and abstention
  10. The trace and verification
  11. Serving: HTTP, MCP and System One
  12. Text in: from a message to a question
  13. Guarding an agent's tool calls (preview)
  14. solvi behind a coding agent's hooks (preview)
  15. A model that writes: generation, agreement and the re-ask loop
  16. Verified charts: a specialist that checks every number (preview)
  17. Checking a catalog: solvi check
  18. Grounded decisions: provenance, audit and safeguards
  19. Printing results: solvi.show
  20. Extracting fields from documents
  21. Command line
  22. Guarantees and limitations