Worthune SDKs

Worthune Model API용 공식 SDK — 인용·감사·신뢰할 수 있는 검증된 금융 계산 모델로, REST 또는 MCP를 통해 호출할 수 있습니다. 출처 표시만 하면 무료이며 API 키가 필요 없습니다. 카탈로그는 검증된 팩(대출 및 신용, 은퇴 및 세금, 스타트업 및 소규모 비즈니스, 그리고 요청에 따라 더 추가됨)으로 성장합니다; 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은 정확성을 단순한 주장이 아니라 산출물(artifact)로 취급합니다:

1. 모든 모델에는 공개된 스펙이 있습니다 — 입력, 단위, 유효 도메인, 정확한 공식, 가정, 제외 사항. 스펙은 GET 요청 한 번으로 확인할 수 있습니다: GET /api/v1/models/{model}/spec.

2. 두 구현이 일치해야 합니다. 각 모델은 스펙에서 독립적으로 재구축되며, 어떤 변경이 배포되기 전에 두 구현 모두 카탈로그 전체에 걸쳐 모델당 250개의 퍼즈(fuzz) 케이스에서 일치해야 합니다. 어디서든 불일치가 발생하면 릴리스가 중단됩니다.

3. 상수에는 출처(provenance)가 있습니다. IRS 한도, 세율 구간, SSA 계수는 1차 출처 인용 및 검증 날짜가 포함된 출처 기반 레지스트리에서 제공되며, 모든 응답은 사용된 상수를 인용합니다.

4. 조용한 변경은 없습니다. 모델 동작 변경은 공개 체인지로그와 함께 스펙 버전 업으로 배포됩니다. 응답은 specVersion을 고정합니다.

Related MCP server: QuantOracle

검증된 계산까지 60초

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 클라이언트, 예제, 그리고 이에 대한 테스트가 포함되어 있습니다. 모델 자체는 — 스펙, 검증된 엔진, 두 번째 구현, 그리고 facts 파이프라인 — worthune.com의 API 뒤에 있습니다. 이러한 분리가 바로 제품입니다: 검증 부담을 지지 않고도 검증된 계산을 서비스로 받을 수 있습니다.

라이선스

MIT (이 저장소의 SDK 코드). API 사용은 Worthune 이용약관의 적용을 받습니다.