Content
# Verovo
<img src="assets/verovo-logo-card.png" alt="Verovo" width="300">
**Know what an AI task really costs, and what its result is worth.**
Verovo connects buyer logs, supplier charges, financial records and business outcomes. Review charges and delivery, allocate direct and shared costs to tasks, and calculate cost per verified success and ROI when the evidence supports it.
For teams buying or operating AI services, the output is a reproducible economic record: task costs, allocation rules, verified results and explicit evidence gaps. The local `economics` command is available on main; invoice extraction, automated optimization and insurance remain future work. [Feature status and build/integrate decisions](docs/feature-status.md).
<p align="center">
<img src="assets/launch/hero.svg" alt="Verovo connects charging rules, usage and payment records, and delivery evidence into one local buyer review that reports charges and delivery as separate PASS / FAIL / UNPROVABLE verdicts" width="720">
</p>
[Website](https://roy-tong.github.io/Verovo/) · [中文](README.zh-CN.md) ·
[Product definition](docs/product-definition.md) · [Buyer task guide](docs/buyer-review.md)
## Three workflows for AI service buyers
| Workflow | Question | Useful next step |
|---|---|---|
| **Charge review** | Do the charges match the applicable rules and records? | Reconcile, pay, request evidence or ask the supplier to review a difference |
| **Task economics** | What does each task cost, including shared expenses? | Compare cost per verified success and evidence-backed business value |
| **Delivery review** | Does the work meet the buyer’s stated requirements? | Accept, request remediation, adjust scope or decide on renewal |
Run either workflow independently or combine them. Correct charges do not establish
successful delivery; poor delivery does not automatically establish incorrect billing.
Missing evidence remains **UNPROVABLE**.
Our users are business and engineering owners accountable for AI spending or results,
with finance and procurement as collaborators. AI support is an initial application
scenario. Coding agents, automation platforms, tools/APIs and model services belong to
the wider scope; coverage is verified task by task.
## Try task economics locally
```bash
git clone https://github.com/roy-tong/Verovo.git
cd Verovo
python3 healthcheck/verovo economics --case examples/task-economics.json --json economics.json --markdown economics.md
```
The synthetic case has two tasks, USD 43.50 in total costs and one verified success.
A duplicate financial row is flagged and excluded. The verified USD 100 value yields
ROI 1.2989. These are demonstration inputs, not customer results. Use your own explicit
records and review coverage before making a financial decision.
## Try a buyer review locally
The new `review` command is a **main-branch preview**, not part of the v0.9.0 tag.
Python 3.9+, standard library only:
```bash
git clone https://github.com/roy-tong/verovo.git
cd verovo
python3 healthcheck/verovo review --sample --html buyer-review.html --json buyer-review.json
```
The synthetic example returns **charges: PASS**, **delivery: FAIL**, and one missing
delivery observation as **UNPROVABLE**. Open `buyer-review.html` to inspect both lanes,
criteria, rule references, observed values and evidence hashes. Every report carries
three **conclusion levels**, kept separate: Level 1 rule consistency (what the run
establishes), Level 2 evidence credibility (rule applicability, source truth, coverage —
reported as not established when absent), Level 3 the buyer business decision (outside
the tool). The six operating stages — Intake → Source Check → Rule Resolution →
Reconciliation → Delivery Assessment → Buyer Decision — map each step to a command in
[docs/review-method/buyer-review-stages.md](docs/review-method/buyer-review-stages.md).
[View the synthetic report](https://roy-tong.github.io/Verovo/examples/buyer-review.html).
Agent hosts can call the same review read-only via MCP (`verovo-mcp`: `verovo_review`,
`verovo_review_template`, `verovo_recount`; no write or submit actions exposed).
To review your own task, copy the [task and observation examples](healthcheck/verovo_healthcheck/demo/buyer-review.json)
and follow the [input guide](docs/buyer-review.md). Checks compare supplied criteria
with values in local JSON files. A person must confirm rule applicability and source
truth; the tool does not infer contract terms or judge arbitrary AI output quality.
## Re-count a bill in 60 seconds
For the existing tagged CLI:
```bash
python3 -m pip install "git+https://github.com/roy-tong/verovo@v0.9.0#subdirectory=healthcheck"
verovo recount --sample
```
The `verovo` PyPI project is not yet published (checked 2026-10-31). The Git tag
installs existing commands; use the main checkout above for the new buyer review.
CLI and Provider SDK releases have separate version numbers.
`prepare` maps supported exports; `recount` applies a selected vendor rule set;
`dispute` organizes supported differences; `recovery` records supplier responses
and realized corrections separately. A rule-priced finding is not recovered money.
[Recount examples](examples/showcase/README.md) · [Periodic reconciliation](RECONCILE.md)
## What is available today
| Capability | Current boundary |
|---|---|
| Buyer review (main preview) | Explicit charge/delivery criteria, local JSON evidence, separate results and offline HTML/JSON; no universal contract parser |
| Supported billing recounts | Selected export formats and versioned rules; applicability must be reviewed |
| Buyer Ledger | Local tool-bill processing and 26 catalog entries; cataloged does not mean connected or validated on real customer bills |
| Developer diagnostics | Local coding-agent log checks, measurement conformance and regression fixtures |
| Task economics (main preview) | Local task/run/usage/cost/outcome case → direct and allocated cost, cost per verified success, ROI when verified value exists; unallocated and unverified items stay explicit |
| Human buyer review | Scope and fees discussed for a concrete task; commercial acceptance and repeat purchase remain under validation |
### Task economics (main preview)
`verovo economics --case case.json --json out.json --markdown out.md` connects
business tasks, agent runs, financialized usage, invoices/cost items and verified
outcomes. Costs are never added across currencies; duplicate financial rows are
reported rather than summed; missing task/run links and shared costs without an
allocation rule stay unallocated; unverified outcomes do not enter the
cost-per-verified-success denominator. See the
[case schema](healthcheck/schemas/task-economics.schema.json) and
[design boundary](docs/task-economics.md). The command is local and makes no
network calls.
[Buyer Ledger](buyer-ledger/README.md) · [Coverage limits](buyer-ledger/REVIEW-20261029.md) ·
[Developer CLI](healthcheck/README.md) · [Conformance](conformance/pack/README.md)
## Start with a real task
[Describe a billing, acceptance or renewal task](https://roy-tong.github.io/Verovo/first-look.html#contact):
name the service, account or task, decision date, available record types and owner.
You can request delivery review without first finding a billing discrepancy.
Free measurement lane / 免费测量通道: bring 20–100 sanitized rows to
[issue #6](https://github.com/roy-tong/verovo/issues/6) or the
[website form](https://roy-tong.github.io/Verovo/services.html) —
免费:带 20–100 行脱敏数据提交到 issue #6 或官网表单。
Providers reviewing upstream spend are buyers in that transaction. Provider-side
work for downstream billing is an extension triggered by a concrete customer dispute,
revenue discrepancy or procurement requirement. It does not redefine the buyer focus.
The existing [free measurement runs](https://roy-tong.github.io/Verovo/services.html)
retain their separate sample-based scope. No fixed enterprise price or recovery
promise is published. Scope and any fee are agreed before commissioned work.
## Evidence and contribution
Local CLI commands do not upload data. Optional GitHub-hosted workflows upload to
GitHub and require a private repository; do not put private bills in public issues.
Synthetic fixtures and test results establish engineering behavior, not customer
adoption, economic recovery or paid demand.
Launch case cards — every number sourced and dated:
[tokendash #37](docs/launch/case-tokendash-37.md) (one message billed as three),
[claude-hud #758](docs/launch/case-claude-hud-758.md) (1-hour cache writes at the
5-minute rate), [VibeMirror-coder-001](docs/launch/case-vibemirror-coder-001.md)
(an independent re-measurement through the free lane). Index and walkthrough
images: [docs/launch](docs/launch/README.md).
[CI](https://github.com/roy-tong/verovo/actions/workflows/conformance.yml) ·
[Claims and reproductions](https://roy-tong.github.io/Verovo/claims.html) ·
[Roadmap](ROADMAP.md) · [Contributing](CONTRIBUTING.md) · [Agent instructions](AGENTS.md)
The standard, SDK, rules and reusable checks support these workflows and remain
open source. [MIT license](LICENSE).
## Extract a supplier invoice into a reviewable draft
Verovo provides an **optional, local invoice2data adapter** for supplier PDF/image/text invoice files. Extraction is not booked to the economics ledger, and it never infers taxes, credits, refunds, foreign exchange or task allocation.
```bash
pip install invoice2data
python3 healthcheck/verovo invoice-intake --file ./invoice.pdf --json ./invoice-draft.json
```
A vendor-specific template may be needed. The result includes a source SHA-256 and explicit \`review_status: unreviewed\` and \`cost_ledger_status: not_imported\` fields. Review the original invoice and contractual rules before assigning costs. Core Verovo remains standard-library-only. See [feature status](docs/feature-status.md).
Connection Info
You Might Also Like
No recommendations available