Worthune SDKs

Offizielle SDKs für die Worthune Model API — verifizierte Finanzberechnungsmodelle, die Sie zitieren und prüfen können und denen Sie vertrauen können, aufrufbar über REST oder MCP. Kostenlos mit Namensnennung, keine API-Schlüssel. Der Katalog wächst in verifizierten Paketen (Kredite & Bonität, Ruhestand & Steuern, Startups & kleine Unternehmen, weitere gesteuert durch Anfragen); GET /api/v1/models ist immer die aktuelle Liste.

• JavaScript / TypeScript: npm install worthune — keine Abhängigkeiten, Node 18+ und Browser

• Python: pip install worthune — keine Abhängigkeiten, Python 3.9+

• Ganz ohne SDK: Es ist einfaches JSON über HTTPS — POST https://worthune.com/api/v1/models/{model} (der Katalog wächst ständig — GET /api/v1/models ist immer die aktuelle Liste)

• MCP (Claude, ChatGPT, Agents): https://worthune.com/api/mcp/mcp — com.worthune/models im offiziellen MCP-Registry

Warum diese Modelle anders sind

Finanzrechner sind leicht zu schreiben und leicht subtil falsch zu machen. Worthune behandelt Genauigkeit als Artefakt, nicht als Behauptung:

1. Jedes Modell hat eine veröffentlichte Spezifikation — Eingaben, Einheiten, gültige Domänen, exakte Formeln, Annahmen, Ausschlüsse. Die Spezifikation ist eine GET-Anfrage: GET /api/v1/models/{model}/spec.

2. Zwei Implementierungen müssen übereinstimmen. Jedes Modell wird unabhängig aus seiner Spezifikation neu aufgebaut, und beide Implementierungen müssen bei 250 gefuzten Fällen pro Modell — über den gesamten Katalog — übereinstimmen, bevor eine Änderung veröffentlicht wird. Uneinigkeit an irgendeiner Stelle stoppt die Veröffentlichung.

3. Konstanten haben eine Herkunft. IRS-Grenzen, Steuerstufen und SSA-Faktoren stammen aus einem quellenbasierten Register mit Primärquellen-Zitaten und Verifikationsdaten — und jede Antwort zitiert die verwendeten Konstanten.

4. Keine stillen Änderungen. Änderungen am Modellverhalten werden als Spezifikationsversions-Upgrades mit einem öffentlichen Changelog veröffentlicht. Antworten fixieren ihre specVersion.

Related MCP server: QuantOracle

In sechzig Sekunden zu einer verifizierten Berechnung

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

Was enthalten ist

Entscheidungsprotokolle: Jede erfolgreiche Antwort enthält record.sha256 — einen Hash über das kanonische JSON von {model, specVersion, inputs, outputs} (Schlüssel rekursiv sortiert). Speichern Sie es neben allem, was Sie auf den Ausgaben aufbauen; berechnen Sie es später neu, um zu beweisen, dass die Zahlen unverändert aus dieser Spezifikationsversion stammen. Beide SDKs implementieren das Rezept bytegenau.

Fair Use & Namensnennung

Alles hier ist kostenlos mit Namensnennung — ein sichtbares „Powered by Worthune" mit einem Link dort, wo Endnutzer Ergebnisse sehen. Fair Use sind 5.000 Modellausführungen pro Monat und App (eine Richtlinie, kein Zähler). Die Details, schriftlich: worthune.com/pricing.

Was dieses Repository ist (und was nicht)

Dieses Repository enthält die API-Clients, Beispiele und deren Tests. Die Modelle selbst — die Spezifikationen, die verifizierte Engine, die zweite Implementierung und die Fakten-Pipeline — leben hinter der API auf worthune.com. Diese Trennung ist das Produkt: Sie erhalten verifizierte Berechnung als Dienst, ohne die Verifizierungslast zu tragen.

Lizenz

MIT (der SDK-Code in diesem Repository). Die API-Nutzung unterliegt den Worthune-Bedingungen.