popov/neuron-tai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

tracher md

Browse Source
This commit is contained in:
Dobromir Popov
2026-07-02 22:03:37 +03:00
parent c3d22c895e
commit 5b142b9976
2 changed files with 173 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

69
QUICKSTART.md
View File

@@ -30,6 +30,75 @@ python3 -m venv .venv
> **NVIDIA GPU (CUDA):** replace the torch line with `pip install torch` (default index).
> **AMD GPU (ROCm):** `pip install torch --index-url https://download.pytorch.org/whl/rocm6.2`
## Bootstrap a tracker on a new machine
Use this when provisioning a fresh LAN/public tracker host. The tracker itself is
lightweight; install the relay too if nodes will connect from NAT, WSL2, mobile,
or other networks where inbound node ports are not reachable.
```bash
# 1. Get the repo onto the tracker host
git clone https://git.d-popov.com/popov/neuron-tai.git AI
cd AI
# 2. Create an isolated Python environment
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip setuptools wheel
# 3. Install only the services needed by the tracker host
.venv/bin/pip install -e packages/tracker -e packages/relay -e packages/gateway
```
For a private LAN tracker, start only the tracker and open the selected TCP port
on the host firewall if other machines will join:
```bash
.venv/bin/meshnet-tracker start --host 0.0.0.0 --port 8080
```
Verify from the tracker host:
```bash
curl -s http://localhost:8080/v1/network/map | python3 -m json.tool
```
Verify from another LAN machine, replacing the IP with the tracker host's LAN IP:
```bash
curl -s http://192.168.0.179:8080/v1/network/map | python3 -m json.tool
```
For a public tracker with relay support, run both services. The relay listens on
`8765`; the tracker below listens on `8081` and advertises the public WebSocket
URL that nodes should use for outbound relay connections:
```bash
# Terminal 1 — relay
.venv/bin/meshnet-relay --host 0.0.0.0 --port 8765
# Terminal 2 — tracker
.venv/bin/meshnet-tracker start \
--host 0.0.0.0 \
--port 8081 \
--relay-url wss://ai.neuron.d-popov.com/ws
```
If this host sits behind Nginx Proxy Manager, point `/` and `/v1/*` at tracker
port `8081`, and point `/ws` plus `/rpc` at relay port `8765` as shown in the
public tracker section below. After the proxy is configured, verify the public
bootstrap endpoint:
```bash
curl -s https://ai.neuron.d-popov.com/v1/network/map | python3 -m json.tool
```
Nodes can then join with either the LAN tracker URL or the public URL:
```bash
.venv/bin/meshnet-node start --tracker http://192.168.0.179:8080 --model Qwen/Qwen2.5-0.5B-Instruct
.venv/bin/meshnet-node start --tracker https://ai.neuron.d-popov.com --model Qwen/Qwen2.5-0.5B-Instruct
```
### Windows / WSL2
Run the Linux commands from WSL, not Git Bash. From the repo opened in Git Bash: