Tob Voltar ao site
Ajuda

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.

uns 15 minutos15 GB livresgrátis, com a sua assinatura

Antes de começar

Abra esta página no computador onde o Tob vai rodar: a instalação é feita nele, não no celular.

  1. Instale o Docker

    Nada para instalar antes

    Veja o chip do seu Mac

    É ele que liga o computador dos bots.

    1. 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.
    2. 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.
    3. 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 $USER

    Depois saia da sessão e entre de novo, para o acesso valer. O Docker Desktop para Linux também funciona.

  2. 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. O app é para Macs com chip Apple. Num Mac com Intel, use o comando do terminal, logo abaixo.

    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 tob na 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 | sh
    irm https://runtob.com/instalar.ps1 | iex

    Ele 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á.

  3. 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.

  4. 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 | iex

Depois 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 ~/tob

No 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\tob

Depois 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.