Worthune SDKs

Worthune Model API 的官方 SDK —— 经过验证的金融计算模型，您可以引用、审计和信任， 可通过 REST 或 MCP 调用。免费使用，需注明出处，无需 API 密钥。目录以经过验证的包形式不断增长（贷款与信贷、退休与税务、初创企业与小企业，更多方向由 requests 引导）；GET /api/v1/models 始终是实时列表。

• JavaScript / TypeScript：npm install worthune —— 零依赖，支持 Node 18+ 和浏览器

• Python：pip install worthune —— 零依赖，支持 Python 3.9+

• 无需 SDK：它就是基于 HTTPS 的纯 JSON —— POST https://worthune.com/api/v1/models/{model} （目录持续增长 —— GET /api/v1/models 始终是实时列表）

• MCP（Claude、ChatGPT、智能体）：https://worthune.com/api/mcp/mcp —— 在官方 MCP 注册表中为 com.worthune/models

为什么这些模型与众不同

金融计算器容易编写，也容易在细微处出错。Worthune 将准确性视为一种产物，而非一句口号：

1. 每个模型都有公开的规范 —— 输入、单位、有效域、精确公式、假设、排除项。规范只需一次 GET 请求： GET /api/v1/models/{model}/spec。

2. 两个实现必须一致。 每个模型都根据其规范独立重建，并且两个实现必须在每个模型 250 个模糊测试用例上匹配 —— 覆盖整个目录 —— 之后任何更改才能发布。任何不一致都会阻止发布。

3. 常量有出处。 IRS 限额、税率等级和 SSA 因子来自一个有来源的注册表，其中包含原始来源引用和验证日期 —— 并且每个响应都会引用其使用的常量。

4. 没有静默更改。 模型行为更改以规范版本升级的形式发布，并附有公开变更日志。响应会固定其 specVersion。

Related MCP server: QuantOracle

六十秒完成一次验证计算

import { Worthune, verifyRecord } from "worthune";

const client = new Worthune();
const result = await client.run("relocation", {
  currentSalary: 95000, newSalary: 108000,
  currentMonthlyExpenses: 4200, newMonthlyExpenses: 4900,
  movingCosts: 6000, currentSavings: 40000,
  annualReturn: 0.07, yearsHorizon: 10,
});

result.outputs.breakEvenMonths;   // 16
result.specVersion;               // "1.0.0" — pinned contract
result.facts;                     // IRS/SSA constants used, with sources
await verifyRecord(result);       // true — SHA-256 audit fingerprint checks out

from worthune import Worthune, verify_record

client = Worthune()
result = client.run("relocation", {...})
result["outputs"]["breakEvenMonths"]
verify_record(result)  # True

包含内容

决策记录： 每个成功响应都包含 record.sha256 —— 这是对 {model, specVersion, inputs, outputs} 的规范 JSON（键递归排序）的哈希。将其存储在与输出相关的任何内容旁边；稍后重新计算以证明这些数字来自该规范版本，且未被篡改。两个 SDK 都实现了该配方，字节级一致。

合理使用与署名

这里的一切都是免费的，但需注明出处 —— 在最终用户看到结果的地方显示可见的“Powered by Worthune”并附上链接。合理使用为每个应用每月 5,000 次模型运行（这是指导原则，不是计量表）。详细信息，请参阅书面说明：worthune.com/pricing。

本仓库是什么（以及不是什么）

本仓库包含 API 客户端、示例及其测试。模型本身 —— 规范、验证引擎、第二实现和事实管道 —— 位于 worthune.com 的 API 之后。这种分离就是产品本身：您获得作为服务的验证计算，而无需承担验证负担。

许可证

MIT（本仓库中的 SDK 代码）。API 使用受 Worthune 条款约束。