---
license: apache-2.0
tags:
  - thox
  - meshstack
  - tooling
---

# thoxmesh-node — distribution channel

Wheels for `thoxmesh_node`, the thin registration helper used by the
**ThoxLLM Cloud** self-serve mesh templates (HF Space and Colab notebook).

This repository exists purely as a **public, auth-free install source**: the
templates repository (`ttracx/thoxllm-cloud`) is private, so a subscriber's
Colab runtime cannot `pip install` from it. Nothing here is a model.

## Install

```bash
pip install "thoxmesh-node @ https://huggingface.co/tommytracx/thoxmesh-node-dist/resolve/main/dist/thoxmesh_node-0.1.0-py3-none-any.whl"
```

## What it does

Registers a node you deploy — a duplicated Hugging Face Space, or a Colab
runtime — with **your own** ThoxLLM Cloud account, so you can address it by
alias:

* pairs as a MeshStack device (Ed25519, single-use join key);
* registers a model endpoint via `POST /v1/mesh/endpoints`;
* heartbeats so the routing table keeps selecting it.

## What it does not do

* It never reads, stores or transmits your **Hugging Face token**. That token
  stays in your own runtime and is used only to download model weights.
* It refuses to send anything matching `hf_*` as a credential, so pasting your
  HF token into the wrong field fails locally rather than leaving your machine.
* It never sends prompt content to any control plane.

Source and full documentation: `templates/` in `ttracx/thoxllm-cloud`.

Apache-2.0.