Instalar o Tob
O Tob roda no seu computador: os bots, as conversas e os logins ficam com você. Você instala o app do Tob e ele cuida do resto. No Linux e nos Macs com Intel, o Docker vem antes. O primeiro download leva alguns minutos.
Antes de começar
- Um Mac (chip Apple ou Intel), um PC com Windows 10 ou 11 de 64 bits, ou um Linux, com 8 GB de memória (16 GB é melhor) e uns 15 GB livres no disco.
- Uma assinatura do Claude (Pro ou Max) ou do ChatGPT (Plus ou Pro). Também serve uma chave de API.
- O computador ligado enquanto os bots trabalham.
Abra esta página no computador onde o Tob vai rodar: a instalação é feita nele, não no celular.
-
Instale o Docker
Nada para instalar antes
Veja o chip do seu Mac
É ele que liga o computador dos bots.
- Clique na maçã no canto de cima da tela → Sobre este Mac. Se aparece Apple M1, M2, M3 ou outro M, é chip Apple. Se aparece Intel, é Intel.
- Chip Apple: não precisa instalar mais nada. O app do Tob traz o Linux onde os bots trabalham, e não pede o Docker. Vá para o passo 2.
- Intel: instale o Docker Desktop para Intel, abra uma vez, espere aparecer Engine running e, no passo 2, use o comando do terminal.
Já usa o Docker Desktop num Mac com chip Apple? Na primeira vez o app pergunta onde o Tob roda: num Linux só dele ou no Docker que você já tem.
O app do Tob traz o Linux onde os bots trabalham, e não pede o Docker. Ele usa o WSL, que é parte do Windows 10 e do 11: se o seu PC ainda não tem, o app instala, o Windows pede a sua permissão e pode pedir para reiniciar. Vá para o passo 2.
Já usa o Docker Desktop? Na primeira vez o app pergunta onde o Tob roda: num Linux só dele ou no Docker que você já tem. Quem prefere instalar pelo terminal, no passo 2, precisa do Docker Desktop.
Instale o Docker Engine pelo script oficial e dê ao seu usuário acesso a ele:
curl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USERDepois saia da sessão e entre de novo, para o acesso valer. O Docker Desktop para Linux também funciona.
-
Baixe o app do Tob
Baixar para Mac Baixar para Windows Baixar para Linux (.deb)Abra o arquivo baixado e arraste o Tob para Aplicativos. Depois abra o Tob em Aplicativos.
Abra o instalador e siga os passos. Se aparecer O Windows protegeu o computador, clique em Mais informações e depois em Executar assim mesmo: o app ainda não tem a assinatura da Microsoft.
Abra o arquivo .deb na central de programas, ou instale no terminal com
sudo apt install ./Tob-Linux.deb. Em distribuições sem .deb, use o AppImage.Na primeira vez, o app mostra Instalar o Tob neste computador. Ele prepara o que falta (num Mac com chip Apple ou no Windows, cria o Linux dos bots; se o computador já tem o Docker, pergunta antes qual dos dois usar, e com o Docker abre o Docker Desktop se precisar), baixa o resto do Tob, o que leva alguns minutos, e entra sozinho.
O app cria a pasta
tobna sua pasta de usuário, com a chave do seu Tob. Ninguém de fora acessa: o Tob só aceita conexões deste computador.Prefere o terminal?
Abra o Terminal: aperte ⌘ Espaço, digite Terminal e aperte Enter. Cole o comando abaixo e aperte Enter.
Abra o PowerShell: clique no menu Iniciar, digite PowerShell e abra o Windows PowerShell. Cole o comando abaixo com Ctrl V e aperte Enter. Se o PowerShell já estava aberto antes do Docker, feche e abra de novo.
Abra um terminal, cole o comando abaixo e aperte Enter.
curl -fsSL https://runtob.com/instalar.sh | shirm https://runtob.com/instalar.ps1 | iexEle instala o mesmo Tob, na mesma pasta, e no fim abre o Tob no navegador. Dá para instalar o app depois: ele encontra o Tob que já está lá.
-
Conecte a sua conta de IA
Na primeira vez, o Tob pede a conta com que os bots vão pensar. Escolha a sua:
- Claude: o Tob abre a página do Claude. Entre com a sua conta e cole no Tob o código que ela mostra.
- ChatGPT: o Tob mostra um código e a página da OpenAI. Entre e digite o código lá.
- Uma chave de API (Anthropic, OpenAI, xAI, OpenRouter ou outra API compatível com a OpenAI ou a Anthropic): cole a chave.
O login do Claude ou do ChatGPT fica no seu computador, guardado pelo próprio Claude Code ou Codex, e as chaves de API ficam criptografadas. O Tob não manda a sua senha para lugar nenhum. Para trocar ou somar contas depois: Configurações → Contas de IA.
-
Crie o seu primeiro bot
Com a conta conectada, toque em Criar o primeiro bot. Dê um nome, escolha a cor e mande a primeira mensagem. Cada bot tem memória e um computador próprio, com navegador e terminal. Os próximos você cria no + embaixo da lista.
Depois de instalar
Abrir de novo
Abra o app do Tob: ele liga o que estiver desligado. Quem instalou pelo terminal abre 127.0.0.1:8787 no mesmo navegador.
Atualizar
O app se atualiza sozinho: quando há versão nova, aparece o botão Atualizar no canto de baixo. O servidor do Tob tem versões próprias: quando sai uma, aparece Atualizar em Configurações → Geral → Servidor, e o app de desktop pega sozinho ao abrir. Pelo terminal, rode o mesmo comando de novo. Os bots, as conversas e os logins ficam.
No navegador
Em Configurações → Dispositivos → Gerar convite, o Tob mostra um código. Abra 127.0.0.1:8787 no navegador, digite o código e aprove o pedido.
E o celular?
Pela sua rede Tailscale: instale no computador e no celular, publique o Tob com tailscale serve --bg 8787 e abra o endereço .ts.net no celular. Ele continua fechado para a internet. O passo a passo está na documentação. O app de iPhone chega em breve pelo TestFlight; até lá, o navegador do celular abre o mesmo Tob.
Tudo o que o Tob faz e onde fica cada opção está em a documentação.
Se algo der errado
“O Docker não está ligado”
O app tenta abrir o Docker Desktop sozinho. Se não der, abra o Docker Desktop, espere aparecer Engine running e toque em Tentar de novo (ou rode o comando de novo).
Falta virtualização (Windows)
A virtualização vem desligada em alguns PCs, e sem ela nem o Linux dos bots nem o Docker ligam. Ela se liga na BIOS do computador, com o nome Intel VT-x, AMD-V ou SVM. O guia do Docker mostra como.
Como desligar o Tob no Mac
Num Mac com chip Apple, com o Linux do Tob, o Tob continua ligado depois que você fecha o app, para as rotinas seguirem e o celular alcançar os bots. Para desligar e devolver a memória ao Mac, use o menu Tob → Desligar o Tob neste Mac e sair. Abrir o app liga de novo. Quem usa o Docker Desktop desliga o Tob fechando o Docker.
Como desligar o Tob no Windows
No Windows, com o Linux do Tob, o Tob continua ligado depois que você fecha o app, para as rotinas seguirem e o celular alcançar os bots. Para desligar e devolver a memória ao Windows, aperte a tecla Alt no app para o menu aparecer e use Tob → Desligar o Tob neste computador e sair. Abrir o app liga de novo, e depois de reiniciar o Windows o Tob só volta quando você abre o app. Quem usa o Docker Desktop desliga o Tob fechando o Docker.
“A porta 8787 está ocupada”
O app escolhe sozinho outra porta livre. Pelo terminal, instale o Tob em outra, por exemplo a 8788:
curl -fsSL https://runtob.com/instalar.sh | TOB_PORT=8788 sh$env:TOB_PORT=8788; irm https://runtob.com/instalar.ps1 | iexDepois o Tob fica em 127.0.0.1:8788.
O download parou ou falta espaço
O Tob precisa de uns 10 GB livres no disco principal, onde o Docker guarda tudo (15 GB com o Linux do Tob, num Mac ou no Windows). Libere espaço e toque em Tentar de novo no app (ou rode o comando de novo): ele continua de onde parou.
Fechei o navegador e o Tob pede um código
Isso acontece num navegador onde o Tob nunca abriu, ou numa janela anônima. Abra o app do Tob, ou rode o comando de novo: os dois entram já com a sua chave.
O Windows diz que protegeu o computador
Aparece porque o app ainda não tem a assinatura da Microsoft. Clique em Mais informações e depois em Executar assim mesmo.
Como tirar o Tob do computador
Isto apaga os bots, as conversas e os logins do Tob neste computador, sem volta.
cd ~/tob && { docker compose stop; docker rm -f tob-bot; docker compose down -v; docker volume rm tob-data; docker image rm ghcr.io/neoemu/tob/hub ghcr.io/neoemu/tob/bot; cd ~ && rm -rf ~/tob; }if (Test-Path $env:USERPROFILE\tob) { cd $env:USERPROFILE\tob; docker compose stop; docker rm -f tob-bot; docker compose down -v; docker volume rm tob-data; docker image rm ghcr.io/neoemu/tob/hub ghcr.io/neoemu/tob/bot; cd ..; Remove-Item -Recurse -Force tob }Num Mac com chip Apple com o Linux do Tob, o comando é outro. Primeiro use o menu Tob → Desligar o Tob neste Mac e sair, depois cole este no Terminal:
LIMA_HOME=~/tob/engine/vm ~/tob/engine/tools/lima-*/bin/limactl delete --force tob; rm -rf ~/tobNo Windows com o Linux do Tob, o comando é outro. Primeiro use o menu Tob → Desligar o Tob neste computador e sair (a tecla Alt mostra o menu), depois cole este no PowerShell:
wsl --unregister tob; Remove-Item -Recurse -Force $env:USERPROFILE\tobDepois desinstale o app do Tob como qualquer outro programa (no Mac, apague o Tob de Aplicativos). O Docker Desktop continua instalado: se não for usar, desinstale também.