Como alojar o Octop com Docker Compose num VPS
Instale o Octop v0.9.19 num VPS com Docker Compose fixado por tag, utilizadores separados, modelo compatível com OpenAI e TLS, sem usar o instalador curl.
O que é o Octop e por que o deve alojar por conta própria
O Octop é um assistente de IA alojado por conta própria para uma família ou uma equipa pequena. O motivo para alojar o Octop por conta própria, em vez de usar apenas uma interface de chat, é manter os utilizadores separados. O Open WebUI disponibiliza uma interface de navegador à frente de um modelo e também suporta vários utilizadores e controlos de acesso. O Octop combina contas com uma função de administrador, um espaço de trabalho privado e um conjunto de credenciais para cada utilizador, além de uma biblioteca de agentes especializados entre os quais cada utilizador pode alternar conforme a tarefa. É esta diferença que permite a um único VPS servir cinco pessoas em vez de uma.
O projeto está em github.com/TencentCloud/Octop. É um único processo que disponibiliza um painel web, uma interface de linha de comandos, canais de chat (Feishu, DingTalk, QQ, Discord, WeCom) e tarefas agendadas, tudo suportado por uma única base de dados SQLite em ~/.octop/. Tudo o que se segue foi escrito com base na tag v0.9.19, publicada em 5 August 2026. Se ainda está a decidir entre plataformas, a comparação de alternativas ao Open WebUI que pode executar num VPS apresenta um panorama mais amplo.
Há um ponto que deve ficar claro antes de lhe dedicar uma noite. Quando este guia foi escrito, o Octop era software anterior à versão 1.0, publicado a partir da organização GitHub de um fornecedor. Desde então, foi criada a tag v1.0.0 em 14 September 2026 e, em 20 November 2026, a tag mais recente é v1.0.3b7, publicada em 18 November 2026, com o repositório a ter cerca de 12,300 estrelas. A versão estável mais recente continua a ser a v1.0.2, publicada em 18 October 2026. Os passos abaixo foram escritos com base na v0.9.19 e não foram novamente testados na versão 1.x. O desenvolvimento é rápido, como mostram os números das versões, e nada neste guia garante um caminho de atualização estável. Fixe uma tag, leia o changelog e mantenha cópias de segurança.
O que precisa antes de começar
- Um VPS com Ubuntu 24.04, Docker Engine e o plugin Compose. Não conhece o Compose? Comece por Noções básicas do Docker Compose para um VPS.
git, porque vai fazer checkout de uma tag de release em vez de obter uma imagem.- Um nome de domínio apontado para o VPS, porque pretende colocar TLS (transport layer security) à frente do serviço.
- Um backend de modelo compatível com a API da OpenAI: um Ollama local, um gateway self-hosted ou uma chave paga.
O próprio Octop é leve. Consiste num processo Python e num ficheiro SQLite. O peso está no backend do modelo. Se pretende executar o modelo no mesmo servidor, dimensione o servidor para esse modelo.
Por que não recomendamos o instalador via curl
O README da v0.9.19 começa com uma instalação de uma linha:
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bashNão recomendamos canalizar esse conteúdo diretamente para bash num servidor importante. O repositório inclui scripts/install.sh, por isso essa cópia tem histórico do git e está associada a uma tag. A cópia disponibilizada pelo bucket do Tencent Cloud Object Storage não é fixada pelo comando acima. O bucket pode disponibilizar bytes diferentes amanhã, e o comando continuará a executá-los. Canalizar o resultado diretamente para bash também significa que a máquina executa o script antes de você ler uma única linha dele.
O instalador também grava no host, e não num contentor. Usa uv para obter o Python 3.12 e criar um ambiente que o seu gestor de pacotes desconhece. Por isso, removê-lo mais tarde exige trabalho manual.
Há duas opções melhores. Obtenha o script, leia-o e só depois execute-o, o que demora trinta segundos: curl -fsSL <url> -o install.sh, depois less install.sh e, por fim, bash install.sh. Ou use Docker, que é o restante deste guia. O pacote PyPI (pip install octop) é pelo menos um artefacto versionado que pode ser fixado numa release.
Implementar o Octop com Docker Compose, fixado na v0.9.19
O ficheiro Compose lançado com a v0.9.19 cria a imagem a partir do repositório. Por isso, neste guia, fixar uma versão significa fazer checkout de uma tag git. Existem imagens publicadas. A árvore da v0.9.19 já inclui um workflow docker-publish.yml, adicionado na v0.9.8 em 15 July 2026, que cria uma imagem e envia-a para o Docker Hub para cada tag v*. Em 20 October 2026, o projeto também publica no registo de contentores do GitHub (docker pull ghcr.io/tencentcloud/octop:1.0.2). Criar a imagem a partir da tag obtida em checkout continua a ser a fixação mais rigorosa, porque compila exatamente o código que foi lido, em vez de confiar numa tag do registo. Isto é mais um passo do que a maioria dos projetos self-hosted exige, porque algo como um workspace AFFiNE self-hosted fixa uma tag de imagem publicada e nunca cria nada no seu VPS. A rotina de clone, checkout e build abaixo é a mesma que o guia de implementação do openGym apresenta. Se já a configurou uma vez, já conhece a estrutura.
git clone https://github.com/TencentCloud/Octop.git
cd Octop
git checkout v0.9.19Este é o serviço definido pelo ficheiro, reduzido às partes relevantes:
services:
octop:
build:
context: ..
dockerfile: docker/Dockerfile
image: octop:latest
container_name: octop
restart: unless-stopped
ports:
- "${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"
volumes:
- ${OCTOP_DATA:-~/.octop}:/data/.octop
environment:
- HOME=/data
- OCTOP_BIND_HOST=0.0.0.0
- OCTOP_PORT=${OCTOP_PORT:-8088}
- OCTOP_DEFAULT_PASSWORD=${OCTOP_DEFAULT_PASSWORD:-octop}
- OCTOP_ADMIN_USERNAME=${OCTOP_ADMIN_USERNAME:-admin}
- OPENAI_API_KEY=${OPENAI_API_KEY:-}Observe o bloco build:. image: octop:latest é o nome da sua própria build, não uma referência de registo. Por isso, latest aqui significa o que compilou mais recentemente. Defina o caminho dos dados explicitamente, em vez de o deixar ao valor predefinido, e atribua uma palavra-passe real à conta de administração antes do primeiro arranque. Coloque isto em docker/.env:
OCTOP_PORT=8088
OCTOP_ADMIN_USERNAME=admin
OCTOP_DEFAULT_PASSWORD=<a long random password>
OCTOP_DATA=/srv/octop-dataHá uma armadilha importante aqui. O Compose lê docker/.env apenas para interpolar os marcadores ${...} no YAML. Uma chave adicionada a esse ficheiro não chega ao contentor, exceto se também estiver listada em environment: no ficheiro Compose. Adicionar OCTOP_ACCESS_TOKEN_TTL apenas a .env não faz absolutamente nada e não gera qualquer aviso. A alternativa é escrever as mesmas chaves em ~/.octop/env dentro do diretório de dados montado. O Octop carrega esse ficheiro no arranque. O guia sobre ficheiros env e secrets no Docker Compose explica por que razão estes dois mecanismos não são equivalentes.
Crie a imagem e inicie o serviço:
docker compose -f docker/docker-compose.yml up -d --build
docker compose -f docker/docker-compose.yml ps
curl http://127.0.0.1:8088/api/healthUma instância saudável responde à verificação de estado com um objeto JSON semelhante a {"ok":true,"started_at":...,"db":...,"users_loaded":0,"agents_running":0}. Se a resposta for diferente, consulte docker compose -f docker/docker-compose.yml logs -f octop antes de abrir o browser.
Agora atribua um nome significativo à imagem que acabou de criar, porque o próximo --build vai substituir octop:latest e deixará de ser possível distinguir as duas:
docker image tag octop:latest octop:0.9.19O primeiro arranque executa octop init e grava as credenciais iniciais no volume de dados:
docker exec -it octop cat /data/.octop/credential.txtOs valores predefinidos são admin / octop e são aplicados apenas na primeira inicialização. É isto que explica uma pergunta frequente: alterar OCTOP_DEFAULT_PASSWORD depois de o contentor já ter arrancado uma vez não muda nada, porque a conta já existe. Altere a palavra-passe no dashboard.
Não publique a porta 8088
A linha ports: acima associa a porta a todas as interfaces da VPS. Assim que o contentor inicia, o dashboard fica disponível na Internet pública sem encriptação. O valor predefinido do próprio Octop em OCTOP_BIND_HOST é 127.0.0.1; o ficheiro Compose substitui-o por 0.0.0.0 porque o processo tem de aceitar tráfego fora do seu próprio namespace de rede. Essa substituição está correta. O problema é a porta publicada, que expõe o serviço.
Edite a linha ports: em docker/docker-compose.yml para que o mapeamento escute apenas na interface de loopback:
ports:
- "127.0.0.1:${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"Não tente corrigir isto com um simples ficheiro de substituição. O Compose concatena as listas ports de vários ficheiros em vez de as substituir. Assim, acaba por publicar ambos os mapeamentos, e o segundo falha ao associar-se à porta. Se quiser manter o ficheiro upstream intacto, use a tag !override na sequência. Essa é a forma documentada de substituir a sequência em vez de a acrescentar. A explicação sobre como o Compose combina vários ficheiros descreve as restantes regras de combinação.
A associação à interface de loopback também resolve um problema que surgiria com a firewall. O Docker escreve as regras das portas publicadas na tabela nat, antes das chains geridas pelo ufw. Por isso, ufw deny 8088 não bloqueia uma porta de um contentor publicada. No Docker Engine 28.0.0 ou posterior, uma porta associada a 127.0.0.1 não pode ser acedida a partir do exterior, independentemente da configuração do ufw. Por isso, esta é a correção adequada, e não uma alternativa inferior. As versões mais antigas do Engine permitem que hosts no mesmo segmento L2, como outras máquinas no switch do seu fornecedor, acedam a portas publicadas em localhost. Execute docker version e atualize o Engine se o servidor indicar uma versão inferior a 28.
Coloque TLS na frente com um reverse proxy
O Caddy é o caminho mais curto, porque solicita o certificado por ACME (ambiente de gestão automática de certificados) por conta própria e faz proxy de WebSockets sem configuração adicional:
octop.example.com {
reverse_proxy 127.0.0.1:8088
}O nginx exige mais atenção, porque o Octop transmite o chat por WebSocket:
server {
listen 443 ssl;
server_name octop.example.com;
ssl_certificate /etc/letsencrypt/live/octop.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/octop.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8088;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 3600s;
}
}Cada linha tem uma função. O chat usa WS /api/agents/{id}/chat/ws, por isso o nginx tem de encaminhar os dois cabeçalhos de upgrade e usar HTTP/1.1 no upstream; proxy_http_version 1.1 torna isso explícito e é necessário nas versões do nginx anteriores à 1.29.7. Sem um upgrade concluído com êxito, o dashboard carrega normalmente, mas o chat não consegue ligar-se; a v0.9.19 termina o estado de transmissão depois de um handshake falhado, em vez de deixar a mensagem pendurada indefinidamente. proxy_buffering off é importante porque o endpoint de retoma human-in-the-loop devolve text/event-stream, e os SSE (eventos enviados pelo servidor) mantidos num buffer do proxy chegam todos de uma vez no final, em vez de serem transmitidos progressivamente. proxy_read_timeout cobre intervalos longos sem dados do upstream: o valor predefinido de 60 segundos pode desligar o WebSocket e registar upstream timed out (110: Connection timed out), mas a v0.9.19 mantém a tarefa do agente em execução depois de uma desconexão. Um cancelamento explícito interrompe a tarefa.
Como a autenticação JWT funciona atrás do proxy
O Octop autentica com um token bearer, não com um cookie. POST /api/auth/login devolve {access_token, token_type, expires_in, user} e as chamadas seguintes incluem Authorization: Bearer <access_token>. Para um reverse proxy, isso é uma boa notícia: não há domínio de cookie, flag Secure nem regra SameSite que possa ser configurada incorretamente. Assim, uma sessão que funcionou em http://127.0.0.1:8088 comporta-se da mesma forma em https://octop.example.com.
É importante conhecer duas consequências antes de disponibilizar o serviço a utilizadores reais.
O WebSocket transporta o token no URL. O endpoint é WS /api/agents/{id}/chat/ws?token=<jwt>, porque o JavaScript do browser não pode definir um cabeçalho Authorization no handshake do WebSocket. O TLS protege esse token durante o trânsito. Mas não o protege dos seus próprios logs: por predefinição, o nginx escreve a linha de pedido completa, incluindo a query string, em access_log. Assim, um token válido de um utilizador real acaba num ficheiro de texto simples no servidor. Registe o caminho sem os argumentos. $uri é o caminho normalizado, já sem a query string. Por isso, coloque isto no bloco http e faça referência a ele no servidor:
log_format octop_noargs '$remote_addr [$time_local] '
'"$request_method $uri $server_protocol" '
'$status $body_bytes_sent';
access_log /var/log/nginx/octop.log octop_noargs;O logout não revoga um token na v0.9.19. OCTOP_ACCESS_TOKEN_TTL tem 86400 como valor predefinido, por isso um token continua válido durante 24 horas após o login. A única forma documentada de invalidar um token é octop admin rotate-jwt-secret. Este comando roda a chave de assinatura armazenada em ~/.octop/secrets/jwt_secret e invalida imediatamente todos os tokens ainda válidos, para todos os utilizadores. Por isso, quando alguém sai da equipa, a ordem é: eliminar o utilizador, rodar o segredo e pedir aos restantes utilizadores que iniciem sessão novamente. Se isso parecer demasiado pesado, reduza o tempo de vida. Lembre-se de adicionar a variável à lista environment: e também a .env:
OCTOP_ACCESS_TOKEN_TTL=28800A proteção contra força bruta já está implementada: OCTOP_LOGIN_MAX_ATTEMPTS tem como valor predefinido 5 falhas e OCTOP_LOGIN_LOCKOUT_SECONDS tem como valor predefinido 900. Assim, um utilizador bloqueado apenas espera quinze minutos, em vez de interpretar o problema como uma instalação avariada. O Octop tem o seu próprio armazenamento de utilizadores e não tinha suporte OIDC documentado na v0.9.19. Portanto, se precisar de início de sessão único real, coloque um proxy de autenticação à frente do serviço. É para isso que serve um servidor Authentik autoalojado. O suporte OIDC integrado chegou na v0.9.24, em 15 August 2026.
Indicar ao Octop um backend de modelos
Os providers são configurados por agente no dashboard, e octop provider list mostra o que está definido. O Octop inclui presets para APIs compatíveis com OpenAI, DashScope (Qwen) e Ollama. As credenciais são armazenadas na tabela providers da sua própria base de dados SQLite. A escolha altera os custos e o que sai do servidor.
Um modelo local com Ollama. Nada sai do servidor, e o custo passa a ser RAM em vez de tokens. O detalhe de rede que costuma causar problemas é o seguinte: um contentor não consegue alcançar o Ollama do host em 127.0.0.1:11434, porque esse endereço corresponde ao loopback do próprio contentor. Adicione uma entrada de gateway do host ao serviço:
extra_hosts:
- "host.docker.internal:host-gateway"Depois, defina o URL base do provider como http://host.docker.internal:11434/v1, que é o caminho compatível com OpenAI do Ollama, e introduza qualquer texto não vazio no campo da chave API. O Ollama ignora esse valor, mas os clientes OpenAI recusam-se a enviar uma chave vazia. O Ollama também tem de escutar para além do loopback para isto funcionar. Isso significa configurar OLLAMA_HOST=0.0.0.0:11434 na unidade systemd. Esta é a parte de risco: a API local do Ollama não exige autenticação. Portanto, uma porta 11434 aberta num IP público transforma o servidor num servidor de modelos disponível para quem o encontrar primeiro. Permita apenas o intervalo privado do Docker, sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp, e bloqueie o restante. Executar Ollama num VPS aborda o dimensionamento do modelo, e a comparação entre Ollama e vLLM explica quando o Ollama deixa de ser o servidor adequado.
Há mais um aviso sobre modelos locais, porque o comportamento parece um bug do Octop, mas não é. Os agentes funcionam através de chamadas a ferramentas, e o prompt do sistema, as definições das ferramentas e o histórico formam um prompt grande. A janela de contexto predefinida do Ollama depende agora da VRAM: 4k abaixo de 24 GiB, 32k de 24 GiB a menos de 48 GiB, e 256k com 48 GiB ou mais. As recomendações atuais indicam pelo menos 64,000 tokens para agentes e ferramentas de programação. Defina num_ctx para acomodar essa carga de trabalho dentro do contexto suportado pelo modelo e da memória disponível, e escolha um modelo que seja realmente bom em chamadas de funções. Uma resposta que termina a meio de uma frase indica o problema oposto e uma definição diferente, num_predict. Por isso, se as respostas forem devolvidas truncadas, vale a pena verificar onde num_predict está definido e o que done_reason indica antes de culpar o agente. Se preferir começar por um candidato específico em vez de uma lista curta, Nemotron 3.5 Lightning merece ser testado. Esse artigo apresenta a tag exata a obter, a RAM necessária e se o desempenho apenas com CPU é suficiente.
Um gateway autoalojado. Coloque um gateway LiteLLM autoalojado entre o Octop e tudo o resto. Terá um único URL base, uma chave separada por utilizador, limites de consumo e um único log. Também pode trocar o modelo por trás do gateway sem editar nada no Octop.
Uma API paga. Oferece a melhor qualidade, com uma compensação clara: o conteúdo das conversas sai do servidor e chega ao provider, o que constitui grande parte do objetivo do self-hosting. A chave é colocada em docker/.env como OPENAI_API_KEY, e o ficheiro Compose já a encaminha.
Seja qual for a opção escolhida, o ficheiro Compose também transporta OCTOP_LANGFUSE_ENABLED, LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY e LANGFUSE_BASE_URL. Assim, pode enviar traces para a sua própria instância Langfuse e ver o que os agentes estão realmente a fazer, em vez de tentar deduzir isso pela janela de chat.
Utilizadores, funções e a biblioteca partilhada de agentes
A conta de administrador criada no primeiro arranque cria e gere as restantes contas. Cada utilizador tem os seus próprios agentes, espaço de trabalho e credenciais. Esse isolamento é assegurado pelo token que o navegador mantém. Além disso, existem modelos de especialistas incluídos e pacotes de competências ao nível da instância. A partilha dos seus próprios agentes com outros utilizadores foi introduzida na v0.9.24, depois da versão fixada aqui.
Tenha cuidado com as ferramentas. O Octop disponibiliza aprovação de ferramentas e proteções para comandos shell, e ambas são reais. No entanto, um agente que execute comandos shell executa-os dentro do contentor Octop, com o seu volume de dados montado. As proteções limitam o que um prompt descuidado pode fazer. Não constituem uma fronteira de sandbox. Por isso, mantenha a aprovação de ferramentas ativada para qualquer pessoa a quem não entregaria acesso a um shell. Se estiver a comparar esta solução com outras opções, o resumo dos agentes de IA autoalojados compara a forma como cada uma lida com isso.
Atualizar um projeto que lança versões com esta rapidez
Os dados por trás deste gráfico
[
{
"version": "v0.9.16",
"days_since_previous_release": 2
},
{
"version": "v0.9.17",
"days_since_previous_release": 3
},
{
"version": "v0.9.18",
"days_since_previous_release": 1
},
{
"version": "v0.9.19",
"days_since_previous_release": 3
}
]Estas são as datas das tags do repositório, contabilizadas em 7 de agosto de 2026. 4 releases com tag foram publicados em nove dias, com um intervalo mínimo de 1 dia, e v0.9.19 foi publicado 3 dias depois da tag anterior. Esta cadência é um bom sinal sobre o projeto, mas um mau motivo para executar latest. Leia as alterações antes de as aplicar:
cd Octop
git fetch --tags
git tag --sort=-creatordate | head
NEW_TAG=$(git tag --sort=-creatordate | head -1)
git log --oneline "v0.9.19..$NEW_TAG"Verifique o que $NEW_TAG contém antes de fazer checkout, porque o projeto inclui tags de versões beta, como v1.0.2b9, juntamente com releases estáveis. Em 20 de novembro de 2026, a tag mais recente é v1.0.3b7, publicada em 18 de novembro de 2026; a release estável mais recente continua a ser v1.0.2, publicada em 18 de outubro de 2026. A passagem de v0.9.19 inclui a release v1.0.0, de 14 de setembro de 2026, pelo que esse log é longo e merece uma leitura atenta.
Faça primeiro uma cópia de segurança, sempre, porque as migrações da base de dados são executadas no arranque e uma migração falhada num projeto que lança versões com esta rapidez ficará a seu cargo:
docker compose -f docker/docker-compose.yml stop
sudo tar czf octop-backup-$(date +%F).tgz -C /srv octop-data
docker compose -f docker/docker-compose.yml startDepois, faça checkout da nova tag e recompile com docker compose -f docker/docker-compose.yml up -d --build. Se algo correr mal, fazer checkout da tag anterior e recompilar repõe o código, mas apenas o tarball repõe a base de dados.
Esse tarball contém octop.db, config.json, o segredo de assinatura JWT e credential.txt, pelo que é tão sensível como o próprio servidor. Mantenha-o com o modo 600 e guarde uma cópia fora do servidor. Numa instalação maior, o projeto também fornece docker/docker-compose.postgres.yml, que executa PostgreSQL com pgvector em vez de SQLite.
Modos de falha e as mensagens que verá
A verificação de integridade nunca responde. curl http://127.0.0.1:8088/api/health fica bloqueado ou recusa a ligação. Consulte docker compose -f docker/docker-compose.yml logs -f octop. Um contentor que termina durante a inicialização pode não conseguir escrever no diretório de dados. Verifique a propriedade do caminho definido em OCTOP_DATA.
O painel carrega, mas o chat não consegue ligar-se. Um handshake WebSocket falhado termina o estado de transmissão em v0.9.19. Abra a consola do navegador e procure uma ligação falhada a wss://octop.example.com/api/agents/.../chat/ws. Confirme se o proxy encaminha o upgrade. Adicione os cabeçalhos proxy_http_version 1.1, Upgrade e Connection.
A resposta completa aparece de uma só vez, com vários segundos de atraso. A transmissão está a funcionar, mas o buffering está ativo. Defina proxy_buffering off.
bind: address already in use. Algo já está a utilizar 8088. sudo ss -tlnp | grep 8088 identifica esse processo. Também verá esta mensagem se tiver adicionado uma segunda entrada ports num ficheiro de override, em vez de editar a entrada original.
A palavra-passe correta é rejeitada. Cinco tentativas incorretas ativam um bloqueio de 900 segundos. Aguarde que termine, em vez de reinstalar.
A nova palavra-passe em .env não teve efeito. Essas credenciais só são aplicadas durante a primeira inicialização. Altere a palavra-passe no painel.
O agente responde, mas nunca executa uma ferramenta. Verifique a alocação de contexto do modelo local e o suporte para function calling. O Ollama recomenda agora pelo menos 64,000 tokens para cargas de trabalho de agentes. Escolha um modelo e um orçamento de memória que ofereçam esse suporte.
FAQ
O Octop substitui o Open WebUI?
Apenas se precisar do que ele acrescenta. O Open WebUI também suporta vários utilizadores, funções e controlos de acesso. O Octop combina contas com uma função de administrador, áreas de trabalho e credenciais por utilizador, além de uma biblioteca selecionável de agentes especializados. Assim, várias pessoas podem partilhar um servidor sem partilhar o mesmo histórico. Se uma única conta for suficiente, o Open WebUI é a opção mais simples e muito mais madura.
Porque não devo usar o script de instalação curl do Octop?
O comando de uma linha da versão v0.9.19 obtém um script de um bucket do Tencent Cloud Object Storage sem fixar o conteúdo a uma tag ou commit do git. O repositório contém uma cópia versionada em scripts/install.sh, mas encaminhar a cópia remota para bash executa-a antes de a ler. O script também instala o software no host com o seu próprio ambiente Python 3.12, fora do gestor de pacotes. Transfira o script e leia-o primeiro, ou faça o deployment com Docker Compose a partir de uma tag verificada.
O Octop pode usar um modelo local em vez de uma API paga?
Sim. O Octop é compatível com APIs OpenAI e inclui um preset Ollama. Por isso, apontá-lo para http://host.docker.internal:11434/v1 funciona depois de adicionar extra_hosts: ["host.docker.internal:host-gateway"] ao contentor e definir OLLAMA_HOST=0.0.0.0:11434 no host. Bloqueie a porta 11434 para a faixa de endereços do Docker na firewall, porque a API local do Ollama não requer autenticação. Verifique a janela de contexto atribuída. Os valores predefinidos do Ollama variam agora consoante a VRAM, e as orientações atuais recomendam pelo menos 64,000 tokens para cargas de trabalho com agentes, dentro do contexto suportado pelo modelo e da memória disponível.
Preciso de um reverse proxy ou posso abrir a porta 8088?
Precisa do proxy. O ficheiro Compose fornecido com o Octop publica a porta 8088 em todas as interfaces, sem TLS. Assim, as palavras-passe e os bearer tokens atravessariam a internet em texto simples. Altere a porta publicada para 127.0.0.1:8088:8088 e coloque Caddy ou nginx à frente, com um certificado. Com nginx, encaminhe os cabeçalhos de upgrade do WebSocket e defina proxy_buffering off. Um upgrade falhado impede a ligação do chat, enquanto o buffering atrasa o fluxo de retoma HITL. Na versão v0.9.19, um handshake falhado termina o estado de streaming, e uma desconexão não cancela uma tarefa ativa do agente.
O Octop está pronto para produção?
Era uma versão anterior à 1.0 e lançava várias releases etiquetadas por semana em agosto de 2026. Em 14 September 2026, criou a tag v1.0.0. Em seguida, lançou várias tags beta 1.0.2 antes da release estável v1.0.2, em 18 October 2026. Em 20 November 2026, a tag mais recente é v1.0.3b7, publicada em 18 November 2026, enquanto v1.0.2 continua a ser a release estável mais recente. O ritmo continua elevado. Considere o Octop promissor, mas ainda não consolidado. É uma opção viável para uma família ou uma equipa interna pequena se fixar uma tag exata, ler o registo de commits antes de cada upgrade e fizer uma cópia de segurança do volume de dados antes de cada rebuild. Não o execute em latest e não coloque dados de clientes nele por enquanto.