Skip to content
Available on private testnetTestnet: yesMainnet: Not availableSoftware: Core bad4a06ea · protocol pqwerai-v8-testnet/1Updated

Create or join a model pool

A model pool runs one exact model (one version, one set of weights) across several PCs. Each PC holds a range of the model's layers, so together they can serve a model that none of them could serve alone. Memory adds up across separate machines, not into one GPU, and the slowest machine and the network set the speed.

What works today

The directories, the relay, pool power, heartbeats and reputation penalties are live on testnet 20777. The first public pool, bonsai-2-community, has existed since 18 November 2026. Running one model split across several independent GPU PCs is not verified yet, and pool members are not paid on chain yet. Creating and joining are signed messages to the directories: no transaction, no fee.

Where pools live

Directory URL
pools-testnet (POOL1) https://pools-testnet.pqwerai.com
pools-testnet2 (seed2) https://pools-testnet2.pqwerai.com
seed1 federated with both; not a public name

The three directories replay the same signed pool log and reach the same state. The explorer shows them on its Pools page.

Read the directories (any tool)

These read-only routes need no key:

curl -s https://pools-testnet.pqwerai.com/v1/pools              # every pool, with capacity, terms and power
curl -s https://pools-testnet.pqwerai.com/v1/pools/<pool id>    # one pool
curl -s "https://pools-testnet.pqwerai.com/v1/pools/<pool id>/log?after=0"   # its signed operation log
curl -s https://pools-testnet.pqwerai.com/v1/models             # models that have pools
curl -s https://pools-testnet.pqwerai.com/v1/models/<model version>/reputation   # members' strikes for a model

Writes (POST /v1/ops) are signed pool operations, normally sent by the wallet.

Join a pool with the wallet

  1. Install wallet 0.8.11 or later and switch to Advanced mode. Open Pools.
  2. Under Your PC shares, pick the compute backend (CUDA, ROCm or Vulkan) and the memory to share in GiB, then press Refresh. With CPU only, the PC can join, but the current split runtime gives layers only to graphics cards.
  3. Pick a model and a pool, for example bonsai-2-community (Bonsai 2 2B, open to graphics cards with 2 GiB or more, price 0). Only pools with open seats filters full pools out.
  4. Read the pool's Commitment and Penalties lines, then press Join with this PC. An open pool admits a matching graphics card without waiting for its coordinator.
  5. Press Work in this pool to start serving your layer range, and Stop working to pause. Verify pool log checks the signed log yourself.

Create a pool

  1. On Pools, select the model and press Create a pool for this model.
  2. Fill in Pool name, Max machines, Model layers, Price per output token (wei), Your coordinator fee (at most 20 %) and the Minimum commitment in hours (0 = none).
  3. Optionally tick Open pool so any graphics card with at least 2 GiB joins without your approval.
  4. Press Sign and create. Your PC becomes the pool's first machine, and the pool is bound to that exact model version and weights.

Commitment and penalties (reputation, no deposit)

Rule Value in the wallet's form
Heartbeat every 5 minutes, signed by the member's node key
Offline silent for more than 15 minutes while on duty → reputation strike offline
Leaving early leave before the minimum commitment → strike early_leave
Forfeit a struck member loses its share of that topology epoch (100 %); the others get it
Rejoin allowed 1 hour after leaving

Strikes follow your wallet across pools of the same model (see the reputation route). There is no bond or deposit yet; an on-chain bond is planned. Full rules: architecture/POOL_POWER_AND_PENALTIES.md in the repository.

Limits

  • The split of one request across independent GPU PCs, proof of computation and pooled on-chain settlement are open.
  • Pool power figures are measured and signed by each member's own node; the directories check their consistency, not their truth.
  • See Model Pools in the Wallet Manual and AI network for the wider design.

Found a problem? Report a documentation issue · Build testnet-rc1+35ec5bd0b5