Skip to content

Commit 61e7553

Browse files
Spider-local (Claude Sonnet 4.6)claude
andcommitted
docs: update RUNBOOK to v2.1, prep README and pyproject for PyPI
RUNBOOK: current C-seed (TEL_GRAMMAR_v1), three topology table, 22-deployment validation results, WHC registry section, tel node CLI section, pip-based install instructions, updated package layout and troubleshooting. README: PyPI badges, pip install section, CLI reference, absolute links for WHITEPAPER and LICENSE so they resolve on the package page. pyproject.toml: keywords, classifiers, Documentation and Release Notes URLs. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 5c222ea commit 61e7553

3 files changed

Lines changed: 305 additions & 114 deletions

File tree

README.md

Lines changed: 52 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Helix TEL — Constitutional Convergence Cryptography
22

3+
[![PyPI version](https://img.shields.io/pypi/v/helix-tel.svg)](https://pypi.org/project/helix-tel/)
4+
[![Python](https://img.shields.io/pypi/pyversions/helix-tel.svg)](https://pypi.org/project/helix-tel/)
5+
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/helixprojectai-code/helix-tel-deploy/blob/main/LICENSE)
6+
37
**Copyright 2026 Stephen Hope, Helix AI Innovations**
48
**License: Apache-2.0**
59

@@ -44,7 +48,7 @@ Given a constitutional grammar `G` and a test suite `T` derived from `G`:
4448

4549
Validated across **22 deployments, 10+ model families, 7 companies (OpenAI, DeepSeek, MoonshotAI, Meta, Google, xAI, NVIDIA), 2 substrate types, and 3 Azure regions**.
4650

47-
See [`WHITEPAPER_Constitutional_Convergence_Cryptography.md`](WHITEPAPER_Constitutional_Convergence_Cryptography.md) for the full technical treatment.
51+
See [`WHITEPAPER_Constitutional_Convergence_Cryptography.md`](https://github.com/helixprojectai-code/helix-tel-deploy/blob/main/WHITEPAPER_Constitutional_Convergence_Cryptography.md) for the full technical treatment.
4852

4953
---
5054

@@ -147,19 +151,61 @@ The registry stores HMAC proofs opaquely — it never sees the C-seed or plainte
147151

148152
---
149153

150-
## Requirements
154+
## Install
151155

152-
- Python 3.10+
153-
- API access to a constitutional AI model (Azure OpenAI, OpenAI, Gemini, or compatible OpenAI-format endpoint)
156+
```bash
157+
pip install helix-tel
158+
```
159+
160+
Or from source:
154161

155162
```bash
156-
pip install -r requirements.txt
163+
git clone https://github.com/helixprojectai-code/helix-tel-deploy
164+
cd helix-tel-deploy
165+
pip install -e .
157166
```
158167

168+
**Requirements:** Python 3.10+ and API access to a constitutional AI model (Azure OpenAI, OpenAI, Gemini, or compatible OpenAI-format endpoint).
169+
159170
---
160171

161172
## Quickstart
162173

174+
### CLI
175+
176+
After `pip install helix-tel`, the `tel` command is available:
177+
178+
```bash
179+
tel --help
180+
181+
# Full v2 node: converge → ping registry → heartbeat
182+
tel node --model gpt-4o --azure --node-id SPIDER --topology universal
183+
184+
# Convergence only
185+
tel converge --endpoint $TEL_ENDPOINT --api-key $TEL_API_KEY --model gpt-4o --azure
186+
187+
# Mesh hub
188+
tel hub
189+
190+
# Send a message
191+
tel send TARGET_NODE "message"
192+
193+
# Listen for inbound
194+
tel listen
195+
```
196+
197+
Config file `tel.yaml`:
198+
```yaml
199+
hub:
200+
host: "your-hub-host"
201+
port: 9738
202+
node:
203+
id: "NODE_A"
204+
seed: ""
205+
```
206+
207+
---
208+
163209
### Verify convergence on your endpoint
164210
165211
```bash
@@ -306,7 +352,7 @@ Prior unversioned runs (pre-2026-05-16) produced C-seed `16ce8df91c0d04ba...` (d
306352

307353
## License
308354

309-
Apache-2.0 — see [LICENSE](LICENSE).
355+
Apache-2.0 — see [LICENSE](https://github.com/helixprojectai-code/helix-tel-deploy/blob/main/LICENSE).
310356

311357
Copyright 2026 Stephen Hope, Helix AI Innovations.
312358

0 commit comments

Comments
 (0)