Auto-hospedagem: guia passo a passo

01 Instale o inferenced CLI

Baixe o arquivo CLI para o seu sistema operacional (v0.2.16 ou mais recente) em GitHub releases.

# Baixar e instalar inferenced CLI
wget https://github.com/gonka-ai/gonka/releases/download/release/v0.2.16-post1/inferenced-linux-amd64.zip
unzip inferenced-linux-amd64.zip
chmod +x inferenced
sudo mv inferenced /usr/local/bin/inferenced

02 Crie uma chave de carteira fria

A carteira fria é usada para gerenciar o nó e receber recompensas.

inferenced keys add cold-wallet

Salve sua frase mnemônica em um lugar seguro!

03 Clone o repositório e configure

git clone https://github.com/gonka-ai/gonka.git -b main
cd gonka/deploy/join
cp config.env.template config.env
# Edite o config.env — insira seus parâmetros

04 Baixe os pesos do modelo

Modelos de rede ativos — MoE FP8 (atualmente MiniMax M2.7, DeepSeek V4 Flash e GLM-5.3 Flash; o conjunto é definido por governance). Carregamento de pesos via HuggingFace CLI. Saiba mais →

pip install -U "huggingface_hub[cli]"
# use the current model id from the network config / governance (example: MiniMax M2.7)
huggingface-cli download MiniMaxAI/MiniMax-M2.7

05 Inicie os serviços Docker

docker compose -f docker-compose.yml -f docker-compose.mlnode.yml pull
source config.env && docker compose up tmkms node -d --no-deps

06 Registre-se on-chain

No servidor, crie uma chave operacional (warm key) e registre o host; depois, na máquina local onde está a chave fria, conceda à chave warm permissões para transações de serviço.

# No servidor, no contêiner api: criar uma chave operacional (warm key)
docker compose run --rm --no-deps -it api /bin/sh
printf '%s\n%s\n' "$KEYRING_PASSWORD" "$KEYRING_PASSWORD" | inferenced keys add "$KEY_NAME" --keyring-backend file

# No mesmo lugar: registrar o host na rede
inferenced register-new-participant \
    $DAPI_API__PUBLIC_URL \
    $ACCOUNT_PUBKEY \
    --node-address $DAPI_CHAIN_NODE__SEED_API_URL

# Na máquina local: conceder permissões à chave warm (taxa 0.002 GNK)
inferenced tx inference grant-ml-ops-permissions \
    cold-wallet <warm-key-address> \
    --from cold-wallet \
    --gas 2000000 --gas-prices 1ngonka \
    --node <seed-api-url>/chain-rpc/

Desde outubro de 2026 (atualização de rede v0.2.16), a concessão de permissões é paga: sem --gas-prices, a rede rejeitará a transação com o erro insufficient fee. Com --gas 2000000 e preço de 1 ngonka por gas, a taxa é de 0.002 GNK. Mantenha uma reserva de GNK na carteira fria: é dela que também são debitadas as taxas da chave warm — o guia oficial recomenda começar com 10 GNK.

07 Configure o SSL e inicie

Configure o DNS (Cloudflare/AWS/GCP/Azure/DO/Hetzner), obtenha um certificado SSL, inicie a rede completa e verifique o registro.

source config.env && \
docker compose -f docker-compose.yml -f docker-compose.mlnode.yml up -d

# Verificar status do nó
curl http://<PUBLIC_IP>:8000/chain-rpc/status

# Verificar registro
curl http://node2.gonka.ai:8000/v2/participants/<cold-wallet-address>