Causalor / Niyati
← Back

Getting Started

Build with the live Niyati surface.

Use Niyati to answer which futures remain reachable, how quickly collapse pressure is rising, and when a path becomes structurally impossible.

Install

The Python SDK publishes as niyati-core and imports as niyati. The JS/WASM SDK publishes as @causalorlabs/niyati-core. The current SDK release line is 0.3.5. 

pip install niyati-core
npm install @causalorlabs/niyati-core
Live API

Production is served from https://api.causalorlabs.com. Anonymous users can call /v1/simulate; solve routes require a valid API key. The current hosted contract version is 0.3.2.

Headers

Content-Type: application/json
X-Niyati-Version: 0.3.2
X-Niyati-Key: <your key>      # required for /v1/solve/*, optional for /v1/simulate

First REST Call

This request works anonymously and returns the theorem-rich simulation contract. 

curl -X POST https://api.causalorlabs.com/v1/simulate \
  -H "Content-Type: application/json" \
  -H "X-Niyati-Version: 0.3.2" \
  -d '{
    "budget": 30,
    "capability": "full",
    "schema": {
      "version": "1.0.0",
      "metadata": {"name": "Quickstart"},
      "time": {"type": "discrete", "horizon": 3},
      "resources": {"money": {"initial": 100, "min": 0, "max": 1000}},
      "variables": {
        "x": {"type": "float", "initial": 0, "min": 0, "max": 10, "discretization": 1}
      },
      "actions": [{
        "name": "increment",
        "cost": {"money": 10},
        "effects": {"x": {"op": "add", "value": 1}},
        "preconditions": []
      }],
      "transitions": [],
      "constraints": [],
      "goal": {
        "type": "threshold",
        "conditions": [{"variable": "x", "operator": "gte", "value": 2}]
      }
    }
  }'

What To Use Next

  • Compare thickness across candidate decisions
  • Watch dominant_root_cause in your UI
  • Call solve routes once you have a developer key
  • Use critical_decisions and survival_policy for guardrails

Execution Model

Mode What it does
Anonymous simulate Fast entry path for demos and schema iteration.
Keyed simulate Same simulation surface with registered account context and higher limits.
Keyed solve/* Reachability, fragility, trajectory, multi-agent, competition, and pareto analysis.

Continue