Worthune SDKs

Официальные SDK для Worthune Model API — проверенные финансовые расчётные модели, которые можно цитировать, аудировать и которым можно доверять, вызываемые через REST или MCP. Бесплатно с указанием авторства, без API-ключей. Каталог пополняется проверенными пакетами (кредиты и займы, пенсии и налоги, стартапы и малый бизнес, а дальнейшие направления определяются запросами); GET /api/v1/models — всегда актуальный список.

• JavaScript / TypeScript: npm install worthune — без зависимостей, Node 18+ и браузеры

• Python: pip install worthune — без зависимостей, Python 3.9+

• Совсем без SDK: это обычный JSON через HTTPS — POST https://worthune.com/api/v1/models/{model} (каталог продолжает расти — GET /api/v1/models всегда актуальный список)

• MCP (Claude, ChatGPT, агенты): https://worthune.com/api/mcp/mcp — com.worthune/models в официальном реестре MCP

Почему эти модели отличаются

Финансовые калькуляторы легко написать и легко допустить в них незаметную ошибку. Worthune рассматривает точность как артефакт, а не как утверждение:

1. У каждой модели есть опубликованная спецификация — входные данные, единицы измерения, допустимые области значений, точные формулы, допущения, исключения. Спецификация — это один GET-запрос: GET /api/v1/models/{model}/spec.

2. Две реализации должны совпадать. Каждая модель независимо пересобирается из своей спецификации, и обе реализации должны совпадать на 250 фаззинг-кейсах на модель — по всему каталогу — прежде чем любое изменение будет выпущено. Любое расхождение останавливает выпуск.

3. Константы имеют подтверждённое происхождение. Лимиты IRS, налоговые диапазоны и факторы SSA берутся из реестра с указанием источников с цитатами из первоисточников и датами проверки — и каждый ответ ссылается на использованные им константы.

4. Никаких скрытых изменений. Изменения поведения моделей выпускаются как повышения версии спецификации с публичным журналом изменений. Ответы фиксируют свой specVersion.

Related MCP server: modelforge

Шестьдесят секунд до проверенного расчёта

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 — хеш канонического JSON вида {model, specVersion, inputs, outputs} (ключи отсортированы рекурсивно). Сохраняйте его рядом с любыми данными, которые вы строите на основе выходных значений; пересчитайте его позже, чтобы доказать, что числа получены из этой версии спецификации без изменений. Оба SDK реализуют этот рецепт побайтово.

Добросовестное использование и указание авторства

Всё здесь бесплатно с указанием авторства — видимая надпись «Powered by Worthune» со ссылкой там, где конечные пользователи видят результаты. Добросовестное использование — это 5000 запусков моделей в месяц на приложение (ориентир, а не счётчик). Подробности — в письменной форме: worthune.com/pricing.

Что такое этот репозиторий (и чем он не является)

Этот репозиторий содержит API-клиенты, примеры и их тесты. Сами модели — спецификации, проверенный движок, вторая реализация и конвейер фактов — находятся за API на worthune.com. Именно это разделение и есть продукт: вы получаете проверенные расчёты как сервис, не беря на себя бремя проверки.

Лицензия

MIT (код SDK в этом репозитории). Использование API регулируется условиями Worthune.