Metadata-Version: 2.4
Name: axiom-robot-sdk
Version: 0.1.0
Summary: The Trust Layer for Physical AI - record every robot action on the immutable chain
Author-email: AXIOM <naveen@axiom.ai>
License: MIT
Project-URL: Homepage, https://github.com/2ool4techai-oss/humanoid
Keywords: robotics,humanoid,blockchain,trust,verification,physical-ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0

# AXIOM — The Trust Layer for Physical AI

> "If it moved, we recorded it. If we recorded it, it cannot be changed. If it cannot be changed, it can be trusted."

## What is AXIOM?

AXIOM is blockchain-anchored robot behavior verification infrastructure. Every action a robot takes — simulation, staging, production — is cryptographically recorded in an immutable hash chain. Nobody can alter a past record. Not the robot company. Not AXIOM.

## Three Products

| Layer | What it does |
|---|---|
| **The Chain** | Immutable SHA-256 hash chain of every robot action |
| **The Score** | Live 0–100 AXIOM Trust Score per robot (the robot credit score) |
| **The Report** | Robot Carfax™ — verified behavior history any enterprise can audit |

## Quick Start

```bash
# Install
pip install -r requirements.txt

# Seed demo data (600 robot actions across 3 robots)
python seed_demo.py

# Start the API
uvicorn axiom:app --reload

# Open the dashboard
open dashboard/index.html
```

## API Endpoints

| Method | Path | Description |
|---|---|---|
| `POST` | `/record` | Record a robot action to the chain |
| `GET` | `/trust/{robot_id}` | Live AXIOM Trust Score |
| `GET` | `/carfax/{robot_id}` | Robot Carfax™ full report |
| `GET` | `/leaderboard` | Public benchmark rankings |
| `GET` | `/verify` | Cryptographic chain integrity check |
| `GET` | `/chain/recent` | Live chain feed (last N blocks) |
| `GET` | `/history/{robot_id}` | Paginated audit history |
| `GET` | `/stats` | Chain statistics |

## Example: Record a robot action

```bash
curl -X POST http://localhost:8000/record \
  -H 'Content-Type: application/json' \
  -d '{
    "robot_id": "FIGURE-03-BMW-LINE7",
    "robot_model": "Figure 03",
    "phase": "production",
    "trigger_type": "routine",
    "action_taken": {"task": "pick_box"},
    "predicted_outcome": "success",
    "actual_outcome": "success",
    "surprise_score": 0.02,
    "model_version": "v2.1.0"
  }'
```

## Example: Get Trust Score

```bash
curl http://localhost:8000/trust/FIGURE-03-BMW-LINE7
```

## Example: Get Robot Carfax

```bash
curl http://localhost:8000/carfax/FIGURE-03-BMW-LINE7
```

## SDK Usage

```python
from sdk.axiom_sdk import AxiomRecorder

recorder = AxiomRecorder("FIGURE-03-BMW-LINE7", api_url="http://localhost:8000")
recorder.record({"task": "pick_box"}, "success", surprise_score=0.02)
```

## Business Model

- **Robot Companies** pay $500–2K/robot/month for private chain recording
- **Enterprise Clients** (BMW, Amazon) pay $50K–500K/year for audit portal
- **Insurance Companies** pay $100K–1M/year for actuarial data API
- **Regulators** via compliance reporting contracts

Seed round: $2M. Target: $10B+.
