Skip to content

Your team of AI agents, on your Mac, Windows or Linux. Agents that talk in channels, write code, review each other and use your tools, on the Claude Code, Codex, OpenCode or Pi you already have. Anything that touches the real world waits for your yes.

2.2 KB
Raw Blame

Tucano num servidor

Rodar o Tucano num servidor seu (VPS ou máquina em casa) e usar pelo navegador: instalar, acessar, manter rodando e o que muda.

No servidor, as rotinas continuam rodando quando o seu computador dorme, e você usa o Tucano pelo navegador, em qualquer computador ou celular. Nada passa por um serviço do Tucano: o servidor é seu. Está em fase nova e experimental.

O que precisa

  • Linux (x64 ou ARM64), com 2 GB de RAM ou mais, e Node.js 24 ou mais novo.
  • Pelo menos um harness instalado e com login feito no servidor, com o usuário que roda o Tucano (por SSH).
  • Opcional: Docker Engine (computadores Linux dos agentes) e Chromium ou Chrome (navegador dos agentes).

Instalar

Como o usuário que vai rodar o Tucano (não root): clonar o repositório, npm ci, npm run build e npm run server. Ele mostra o endereço com um token (http://127.0.0.1:7337/?token=…). Abra esse link uma vez: o token entra no navegador e um cookie mantém. Pra deslogar todos os navegadores, apague o arquivo server-token na pasta de dados e reinicie.

Acessar

Por padrão ele só escuta no próprio servidor, porque quem tem o token controla os agentes. Jeitos de chegar:

  • Túnel SSH (ssh -L 7337:127.0.0.1:7337 …), o mais simples.
  • Tailscale ou outra rede privada, com TUCANO_HOST no endereço dela.
  • Um proxy reverso com HTTPS (Caddy, nginx) num domínio seu.

Nunca exponha a porta 7337 num endereço público sem HTTPS.

Manter rodando

Como um serviço do systemd com o seu usuário. Pra atualizar: git pull && npm ci && npm run build e reiniciar o serviço. Não há atualização automática.

Variáveis: TUCANO_DATA (a pasta de dados, ~/.tucano-server por padrão), TUCANO_HOST, TUCANO_PORT (7337) e TUCANO_TOKEN.

O que muda em relação ao app

  • Notificações: só pelo Telegram (o navegador não avisa).
  • Conector com OAuth: a autorização abre no seu navegador; ao terminar, você cola o endereço em que a página parou.
  • Escolher uma pasta pede o caminho dela no servidor.
  • Apps do computador não existem no servidor (não há tela).
  • Um Tucano por pasta de dados: não rode o app e o servidor na mesma pasta ao mesmo tempo.
  • Um servidor é um workspace só (o da pasta de dados).