---
title: Substrate Mesh Runtime Connector API
emoji: 🧬
colorFrom: blue
colorTo: indigo
sdk: docker
app_file: app.py
app_port: 7860
pinned: false
license: cc-by-nc-sa-4.0
short_description: Private Substrate connector API for GPT Actions
---

# Substrate Mesh Runtime — Primordial OS Runtime Connector API Wrapper v3.3.1

Created and developed by Collin D. Weber.  
Systems Architect / Systems Integrity Steward: Collin D. Weber.

## Purpose

This packet turns the v3.3 Primordial OS Runtime Connector contract into a deployable HTTPS API wrapper for GPT Actions.

It is intended to be deployed as a private Hugging Face Docker Space first, then connected to the existing Primordial OS Runtime GPT through the GPT Builder Action panel.

## Boundary

- canonical source artifacts remain read-only;
- canonical Primordial Lexicon remains read-only;
- user/GPT outputs are workspace-local overlay proposals only;
- no final validation claims;
- no publication authority;
- no clinical/legal/deployment authority;
- human review remains required;
- HIR × OAM pressure receipt is preserved.

## API routes

```text
GET  /v1/mesh/health
POST /v1/mesh/command
GET  /v1/mesh/receipt/{command_id}?workspace_id=...
```

`/v1/mesh/command` and `/v1/mesh/receipt/{command_id}` require:

```text
Authorization: Bearer <SUBSTRATE_ACTION_KEY>
```

## Local test

```bash
export SUBSTRATE_ACTION_KEY="test-secret-key"
python validate_substrate_connector_api_v3_3_1.py
```

## Local server

```bash
export SUBSTRATE_ACTION_KEY="replace-with-a-long-random-secret"
uvicorn app:app --host 0.0.0.0 --port 7860
```

Health check:

```bash
curl http://localhost:7860/v1/mesh/health
```

Command test:

```bash
curl -X POST http://localhost:7860/v1/mesh/command   -H "Authorization: Bearer $SUBSTRATE_ACTION_KEY"   -H "Content-Type: application/json"   -d @examples/requests/robotics_humans_dna_request.json
```

## GPT Action schema

Use:

```text
openapi/openapi.yaml
```

Before pasting into GPT Actions, replace:

```text
https://YOUR-HF-SPACE.hf.space
```

with your deployed Hugging Face Space URL.

## Deployment posture

This packet is API-wrapper-ready. It does not deploy itself. The operator still creates the Hugging Face Docker Space, adds `SUBSTRATE_ACTION_KEY` as a Space secret, uploads these files, and then connects the schema to the Primordial OS Runtime GPT Action panel.