closedhumanPR #122Other

hackathon/implement NANDA Simulation Sandbox API and serve SKILL.md phase 2

Implementation of NANDA Simulation Sandbox (SaaS). This service allows remote or lightweight AI agents (e.g., OpenClaw agents) to run full NANDA Town simulations, calculate performance metrics, and retrieve adversarial validator results…

Author

tanishaacodes avatar

@tanishaacodes

github profile →
Status
Closed without merging
Opened on
Jul 9
Branch
hackathon/tani-simulation-sandbox

Description

The pitch.

# Summary
Implementation of **NANDA Simulation Sandbox (SaaS)**. This service allows remote or lightweight AI agents (e.g., OpenClaw agents) to run full NANDA Town simulations, calculate performance metrics, and retrieve adversarial validator results via a single HTTP request without installing Python 3.12 or simulator packages locally.

All changes are fully verified, linted, typechecked, and pass the local CI checklist.

---

## 1. File Changes & Architecture

### Sandbox Service
* `apps/nanda-sandbox/main.py`:
  - FastAPI application implementing `/health`, `/scenarios`, `/simulate`, and `/skill.md`.
  - Runs simulations programmatically using `ScenarioRunner` and `validate_trace` from `nest_core` inside secure temporary directories.
* `apps/nanda-sandbox/requirements.txt`:
  - Web service dependencies.
* `Dockerfile` (Root):
  - Builds and synchronizes the entire workspace using `uv sync` to make all local NANDA Town packages natively importable.
* `railway.json` (Root):
  - Wires the build provider to the Dockerfile builder context.

### SkillMD Documentation
* `docs/hackathon/solutions/nanda-sandbox-skill.md`:
  - OpenClaw-compatible `SKILL.md` documenting curl invocation formats, YAML payload schemas, and agent walkthrough steps.
  - The API also dynamically serves this file at `/skill.md` as requested by the guidelines.

### Unit Tests
* `apps/nanda-sandbox/tests/test_main.py`:
  - Unit tests verifying endpoints, valid scenario runs, validation checks, and `/skill.md` exposure.

---

## 2. Verification

Run local checks:
```bash
# Run sandbox unit tests
uv run pytest apps/nanda-sandbox/tests/test_main.py -v

# Run full project checks
make ci-local

Try it

Open PR on GitHubView diff

Checkout locally

git fetch origin pull/122/head:pr-122
git checkout pr-122