{"id":50603,"date":"2026-07-31T08:32:49","date_gmt":"2026-07-31T11:32:49","guid":{"rendered":"https:\/\/www.hostinger.com\/pt\/tutoriais\/como-configurar-o-hermes-workspace\/"},"modified":"2026-07-31T08:32:49","modified_gmt":"2026-07-31T11:32:49","slug":"como-configurar-o-hermes-workspace","status":"publish","type":"post","link":"\/pt\/tutoriais\/como-configurar-o-hermes-workspace\/","title":{"rendered":"Como configurar o Hermes Workspace"},"content":{"rendered":"<p class=\"wp-block-paragraph\">O Hermes Workspace &eacute; uma <strong>interface web de c&oacute;digo aberto para o Hermes Agent<\/strong>, um agente de IA que se aprimora sozinho, desenvolvido pela Nous Research.<\/p><p class=\"wp-block-paragraph\">Ele re&uacute;ne o chat do agente, a mem&oacute;ria persistente, o mercado de habilidades, o terminal e a orquestra&ccedil;&atilde;o multiagente em um &uacute;nico painel auto-hospedado, que voc&ecirc; pode acessar de qualquer dispositivo.<\/p><p class=\"wp-block-paragraph\">Para configurar o Hermes Workspace em um servidor virtual privado (VPS), fa&ccedil;a a instala&ccedil;&atilde;o do Workspace junto com o agente, configure o gateway e o painel e acesse a interface por meio de um t&uacute;nel SSH ou de um dom&iacute;nio.<\/p><p class=\"wp-block-paragraph\">Executar o Hermes Workspace em um VPS mant&eacute;m suas conversas, a mem&oacute;ria do agente e as chaves de API na infraestrutura que voc&ecirc; controla, em vez de depender de servi&ccedil;os de terceiros.<\/p><h2 class=\"wp-block-heading\" id=\"h-1-verifique-os-pre-requisitos\">1. Verifique os pr&eacute;-requisitos<\/h2><p class=\"wp-block-paragraph\">O Hermes Workspace roda em um VPS com <strong>pelo menos<\/strong> <strong>2 GB de RAM<\/strong> e uma das principais distribui&ccedil;&otilde;es Linux, como o Ubuntu 24.04. O Workspace funciona como interface, enquanto o <a href=\"\/pt\/tutoriais\/o-que-e-o-agente-hermes\/\" target=\"_blank\" rel=\"noreferrer noopener\">Hermes Agent<\/a> cuida das tarefas em segundo plano.<\/p><p class=\"wp-block-paragraph\"><a href=\"\/pt\/tutoriais\/como-configurar-vps\/\" target=\"_blank\" rel=\"noreferrer noopener\">Configure um VPS<\/a> primeiro, se ainda n&atilde;o tiver um, e depois conecte-se a ele via SSH.<\/p><p class=\"wp-block-paragraph\">O Hermes Workspace precisa de tr&ecirc;s ferramentas: Node.js 22 ou superior, Python 3.11 ou superior e <strong>pnpm<\/strong>. O Ubuntu 24.04 j&aacute; vem com uma vers&atilde;o compat&iacute;vel do Python, ent&atilde;o voc&ecirc; s&oacute; precisa <a href=\"\/pt\/tutoriais\/instalar-node-js-ubuntu\/\" target=\"_blank\" rel=\"noreferrer noopener\">realizar a instala&ccedil;&atilde;o do Node.js<\/a> e do <strong>pnpm<\/strong>.<\/p><p class=\"wp-block-paragraph\">Primeiro, atualize o sistema:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">sudo apt update<\/pre><p class=\"wp-block-paragraph\">Realize a instala&ccedil;&atilde;o do <strong>curl<\/strong> e do <strong>git<\/strong> e, em seguida, adicione o reposit&oacute;rio NodeSource para o Node.js 22:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">sudo apt install -y curl git\ncurl -fsSL https:\/\/deb.nodesource.com\/setup_22.x | sudo -E bash -\nsudo apt install -y nodejs<\/pre><p class=\"wp-block-paragraph\">Realize a instala&ccedil;&atilde;o do pnpm usando o <strong>npm<\/strong>:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">sudo npm install -g pnpm<\/pre><p class=\"wp-block-paragraph\">Verifique se cada ferramenta est&aacute; instalada e se est&aacute; na vers&atilde;o necess&aacute;ria antes de continuar:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">node -v # 22.x or higher\npython3 -V # 3.11 or higher\npnpm -v<\/pre><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca089613d4\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca089613d4\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-pre-requisitos-no-terminal-python-versoes-do-pnpm.png\/w=1024,h=1024,fit=scale-down\" alt=\"como configurar o Hermes Workspace: Terminal mostrando as vers&otilde;es do Node.js 22.22.3, Python 3.12.3, e pnpm 11.5.1.\" class=\"wp-image-57149\" title=\"hermes-workspace-prerequisites-terminal-node-python-pnpm-versions\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><h2 class=\"wp-block-heading\" id=\"h-2-instale-o-hermes-workspace\">2. Instale o Hermes Workspace<\/h2><p class=\"wp-block-paragraph\">Se voc&ecirc; nunca instalou o Hermes Agent antes, configure o Hermes Workspace com o instalador oficial de uma linha. Ele clona o workspace, instala o Hermes Agent pelo PyPI e cria os arquivos iniciais <strong>.env<\/strong> com um &uacute;nico comando:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl -fsSL https:\/\/raw.githubusercontent.com\/outsourc-e\/hermes-workspace\/main\/install.sh | bash<\/pre><p class=\"wp-block-paragraph\">Na primeira execu&ccedil;&atilde;o, o instalador pede que voc&ecirc; escolha um provedor de modelo e insira uma chave de API, ent&atilde;o tenha uma chave dispon&iacute;vel. Quando terminar, voc&ecirc; ver&aacute; uma mensagem de confirma&ccedil;&atilde;o indicando que a instala&ccedil;&atilde;o foi bem-sucedida.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca08963893\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca08963893\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-instalacao-do-terminal-instalacao-concluida-proximos-passos.png\/w=1024,h=1024,fit=scale-down\" alt=\"Terminal exibindo a mensagem de instala&ccedil;&atilde;o conclu&iacute;da e as pr&oacute;ximas etapas de configura&ccedil;&atilde;o.\" class=\"wp-image-57151\" title=\"hermes-workspace-install-terminal-install-complete-next-steps\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p class=\"wp-block-paragraph\">Se voc&ecirc; j&aacute; <a href=\"\/pt\/tutoriais\/como-configurar-o-hermes-agent\/\" target=\"_blank\" rel=\"noreferrer noopener\">instalou o Hermes Agent<\/a>, pule o instalador de uma linha. Em vez disso, clone o reposit&oacute;rio do Hermes Workspace separadamente e configure-o para os seus servi&ccedil;os existentes:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">git clone https:\/\/github.com\/outsourc-e\/hermes-workspace.git\ncd hermes-workspace\npnpm install\ncp .env.example .env\necho 'HERMES_API_URL=http:\/\/127.0.0.1:8642' &gt;&gt; .env\necho 'HERMES_DASHBOARD_URL=http:\/\/127.0.0.1:9119' &gt;&gt; .env<\/pre><p class=\"wp-block-paragraph\">Use <strong>127.0.0.1<\/strong> se o agente estiver rodando no mesmo servidor. Use o endere&ccedil;o IP real do servidor se ele estiver rodando em outro lugar. De qualquer forma, voc&ecirc; ainda vai precisar definir a chave do gateway em seguida.<\/p><p class=\"wp-block-paragraph\">Independentemente do seu m&eacute;todo de instala&ccedil;&atilde;o, o workspace e o gateway precisam compartilhar a mesma chave secreta. Isso requer tr&ecirc;s novas entradas em dois arquivos.<\/p><p class=\"wp-block-paragraph\">Primeiro, gere a chave secreta e copie-a em um lugar seguro:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">openssl rand -hex 32<\/pre><p class=\"wp-block-paragraph\">Abra o arquivo de ambiente do agente com o <a href=\"\/pt\/tutoriais\/como-instalar-editor-de-texto-nano\/\" target=\"_blank\" rel=\"noreferrer noopener\">editor de texto nano<\/a>:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">nano ~\/.hermes\/.env<\/pre><p class=\"wp-block-paragraph\">Adicione essas duas linhas ao arquivo. Substitua <strong>seu-gateway-secret<\/strong> pela chave secreta que voc&ecirc; gerou antes:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">API_SERVER_ENABLED=true\nAPI_SERVER_KEY=your-gateway-secret<\/pre><p class=\"wp-block-paragraph\">A vari&aacute;vel <strong>API_SERVER_ENABLED<\/strong> ativa a <strong>API HTTP<\/strong> usada pelo Workspace, e <strong>API_SERVER_KEY<\/strong> protege a API com uma chave secreta.<\/p><p class=\"wp-block-paragraph\">O gateway precisa dessas duas configura&ccedil;&otilde;es para disponibilizar a API, mesmo quando o espa&ccedil;o de trabalho e o gateway rodam no mesmo servidor. &Eacute; f&aacute;cil deixar essa etapa de lado, porque, em uma configura&ccedil;&atilde;o apenas local, pode parecer que n&atilde;o precisa de senha.<\/p><p class=\"wp-block-paragraph\">Salve o arquivo e feche o <strong>nano<\/strong> com <strong>Ctrl+X &rarr; Y &rarr; Enter<\/strong>.<\/p><p class=\"wp-block-paragraph\">Agora, abra o arquivo de ambiente do espa&ccedil;o de trabalho:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">nano ~\/hermes-workspace\/.env<\/pre><p class=\"wp-block-paragraph\">Adicione o token usando a mesma chave secreta, para que <code>API_SERVER_KEY<\/code> e <code><strong>HERMES_API_TOKEN<\/strong><\/code> tenham o mesmo valor:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">HERMES_API_TOKEN=your-gateway-secret<\/pre><p class=\"wp-block-paragraph\">Salve o arquivo da mesma forma para concluir a configura&ccedil;&atilde;o.<\/p><h2 class=\"wp-block-heading\" id=\"h-3-inicie-o-gateway-e-o-workspace\">3. Inicie o gateway e o workspace<\/h2><p class=\"wp-block-paragraph\">Tr&ecirc;s servi&ccedil;os do Hermes s&atilde;o executados juntos: o gateway na porta <strong>8642<\/strong>, o painel na porta <strong>9119<\/strong> e a interface do workspace na porta <strong>3000<\/strong>. O gateway e o painel fazem parte do Hermes Agent, enquanto a interface &eacute; a parte que voc&ecirc; usa no navegador.<\/p><p class=\"wp-block-paragraph\">V&aacute; at&eacute; a pasta do workspace:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">cd ~\/hermes-workspace<\/pre><p class=\"wp-block-paragraph\">Inicie o gateway, o painel e a interface do workspace com um &uacute;nico comando:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">npx concurrently --names \"gateway,dashboard,workspace\" --prefix-colors \"blue,green,yellow\" \"hermes gateway run\" \"hermes dashboard\" \"pnpm dev\"<\/pre><p>        <div class=\"protip\">\n            <div class=\"protip__heading\">\n                <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\">\n                    <path d=\"M1.49234 23.5024C1.23229 23.5024 0.972242 23.4024 0.782206 23.2123C0.562165 22.9923 0.452144 22.6822 0.502153 22.3722C0.562165 21.9221 1.14227 17.9113 3.00262 16.351C3.63274 15.8209 4.43289 15.5509 5.26305 15.5609C6.09321 15.5909 6.87335 15.9109 7.47347 16.4911C8.6937 17.6913 8.76371 19.6717 7.6435 20.9919C6.0832 22.8523 2.08245 23.4324 1.63237 23.4924C1.59236 23.4924 1.54235 23.4924 1.50234 23.4924L1.49234 23.5024ZM5.16303 17.5613C4.84297 17.5613 4.53291 17.6713 4.29287 17.8813C3.60274 18.4614 3.07264 19.9317 2.75258 21.242C4.06282 20.9219 5.5331 20.3918 6.11321 19.7017C6.55329 19.1716 6.54329 18.3814 6.0832 17.9213C5.85316 17.7013 5.5431 17.5713 5.20304 17.5613C5.19304 17.5613 5.17303 17.5613 5.16303 17.5613ZM11.7243 21.8821C11.4942 21.8821 11.2642 21.8021 11.0841 21.652C10.8541 21.462 10.7241 21.1819 10.7241 20.8819V15.9109L8.08358 13.2705H3.11264C2.81259 13.2705 2.53254 13.1404 2.3425 12.9104C2.15246 12.6803 2.07245 12.3803 2.12246 12.0902C2.19247 11.7102 2.84259 8.36953 4.70294 7.12929C6.33325 6.04909 8.96375 6.49918 10.244 6.80923C11.5442 4.96889 13.2546 3.4286 15.2349 2.33839C17.4553 1.11816 19.9858 0.518051 22.4963 0.498047C23.0464 0.498047 23.4865 0.948132 23.4865 1.49824C23.4865 5.0389 22.3763 9.97983 17.1753 13.7605C17.4853 15.0408 17.9354 17.6613 16.8552 19.2816C15.615 21.1419 12.2744 21.7921 11.8943 21.8621C11.8343 21.8721 11.7743 21.8821 11.7143 21.8821H11.7243ZM12.7245 16.181V19.6016C13.7146 19.2916 14.7948 18.7915 15.2049 18.1814C15.675 17.4812 15.605 16.091 15.385 14.9008C14.5248 15.3808 13.6346 15.8109 12.7245 16.181ZM9.66388 12.0302L11.9643 14.3307C13.1845 13.8306 14.3648 13.2204 15.485 12.5103C19.9358 9.51974 21.2361 5.60901 21.4561 2.53843C19.6157 2.67846 17.8254 3.20856 16.2051 4.09872C14.2847 5.14892 12.6544 6.68921 11.4942 8.54956C10.7841 9.65977 10.174 10.82 9.66388 12.0302ZM4.39289 11.2701H7.81353C8.1936 10.3599 8.63368 9.46974 9.11377 8.60957C7.92355 8.38953 6.51329 8.31952 5.81315 8.78961C5.19304 9.19968 4.70294 10.3099 4.39289 11.2701Z\" fill=\"#673DE6\"\/>\n                <\/svg>\n                <p class=\"protip__title\">\n                    &#128161; Dica                <\/p>\n            <\/div>\n            <p class=\"protip__content\"> Algumas documenta&ccedil;&otilde;es sugerem usar <strong>pnpm start:all<\/strong>, o que deveria fazer o mesmo que executar os tr&ecirc;s servi&ccedil;os. Nos nossos testes, por&eacute;m, isso deixa o painel de controle de fora.<br>\nSem o painel de controle, recursos essenciais como o chat ainda funcionam, mas voc&ecirc; perde o acesso a sess&otilde;es, habilidades, mem&oacute;ria e tarefas.<br>\nRecomendamos iniciar todos os servi&ccedil;os com <strong>npx concurrently<\/strong>, porque &eacute; mais confi&aacute;vel e permite que o workspace funcione com todos os recursos.<\/p>\n                    <\/div>\n        \n\n\n\n<\/p><p class=\"wp-block-paragraph\">A sa&iacute;da exibe o URL da interface do workspace no IP do seu VPS, na porta 3000, como, por exemplo, <strong>http:\/\/22.222.222.84:3000<\/strong>. Abra esse endere&ccedil;o no navegador.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca08966114\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca08966114\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-start-services-terminal-workspace-ui-url.png\/w=1024,h=1024,fit=scale-down\" alt=\"Terminal exibindo a interface do workspace pronta, com suas URLs local e de rede.\" class=\"wp-image-57150\" title=\"hermes-workspace-start-services-terminal-workspace-ui-url\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p class=\"wp-block-paragraph\">O painel carrega pronto para uso, ent&atilde;o voc&ecirc; pode come&ccedil;ar a conversar, acessar a mem&oacute;ria e explorar as habilidades ou abrir o terminal integrado na hora.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca08968457\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca08968457\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-painel-iniciar-uma-sessao-tela-inicial.png\/w=1024,h=1024,fit=scale-down\" alt=\"Painel do Hermes Workspace com a barra lateral e a tela de uma nova sess&atilde;o de conversa.\" class=\"wp-image-57148\" title=\"hermes-workspace-dashboard-begin-a-session-home-screen\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p class=\"wp-block-paragraph\">Se voc&ecirc; fechar a sess&atilde;o SSH ou perder a conex&atilde;o, esses processos tamb&eacute;m s&atilde;o encerrados. Para mant&ecirc;-los em execu&ccedil;&atilde;o mesmo depois que o SSH se desconectar, execute-os dentro de uma <a href=\"\/pt\/tutoriais\/como-usar-tmux\/\" target=\"_blank\" rel=\"noreferrer noopener\">sess&atilde;o do tmux<\/a>:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">tmux new -s hermes\ncd ~\/hermes-workspace\nnpx concurrently \"hermes gateway run\" \"hermes dashboard\" \"pnpm dev\"<\/pre><p class=\"wp-block-paragraph\">Desconecte com <strong>Ctrl+B<\/strong> e, em seguida, <strong>D<\/strong>. Reconecte mais tarde com <strong>tmux attach -t hermes<\/strong>.<\/p><p class=\"wp-block-paragraph\">Para confirmar se o gateway e o painel de controle est&atilde;o respondendo, abra uma nova janela de terminal e execute estas duas verifica&ccedil;&otilde;es:<\/p><pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">curl http:\/\/127.0.0.1:8642\/health\ncurl http:\/\/127.0.0.1:9119\/api\/status<\/pre><p class=\"wp-block-paragraph\">O primeiro comando verifica o gateway, que retorna <strong>{&ldquo;status&rdquo;:&rdquo;ok&rdquo;,&rdquo;platform&rdquo;:&rdquo;hermes-agent&rdquo;}<\/strong>.<\/p><p class=\"wp-block-paragraph\">O segundo comando verifica o painel. Os campos importantes s&atilde;o <strong>&ldquo;gateway_running&rdquo;:true<\/strong> e o estado do <strong>api_server<\/strong> como <strong>&ldquo;connected&rdquo;<\/strong>, o que confirma que o gateway est&aacute; funcionando e que seu servidor de API est&aacute; conectado.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca0896ad5e\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca0896ad5e\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-verificar-o-status-de-integridade-do-terminal-curl-saida.png\/w=1024,h=1024,fit=scale-down\" alt=\"Terminal exibindo as respostas do curl para as verifica&ccedil;&otilde;es de sa&uacute;de do gateway e do status do dashboard.\" class=\"wp-image-57152\" title=\"hermes-workspace-verify-terminal-curl-health-status-output\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p class=\"wp-block-paragraph\">Voc&ecirc; tamb&eacute;m precisa verificar o modo de execu&ccedil;&atilde;o no terminal que est&aacute; rodando os servi&ccedil;os. Uma linha no log do workspace que inclua <strong>mode=zero-fork<\/strong> indica que o gateway e o painel foram emparelhados.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca0896cea8\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca0896cea8\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/hermes-workspace-verify-terminal-workspace-log-mode-zero-fork.png\/w=1024,h=1024,fit=scale-down\" alt=\"Workspace log showing mode=zero-fork after the gateway and dashboard pair\" class=\"wp-image-57153\" title=\"hermes-workspace-verify-terminal-workspace-log-mode-zero-fork\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><h2 class=\"wp-block-heading\" id=\"h-como-configurar-o-hermes-workspace-na-hostinger\">Como configurar o Hermes Workspace na Hostinger<\/h2><p class=\"wp-block-paragraph\">Na Hostinger, o Hermes Workspace est&aacute; dispon&iacute;vel como um template Docker com instala&ccedil;&atilde;o em um clique que configura automaticamente os cont&ecirc;ineres do agente e do workspace.<\/p><p class=\"wp-block-paragraph\">Isso evita que voc&ecirc; precise executar comandos de instala&ccedil;&atilde;o e configura&ccedil;&atilde;o manualmente, o que pode causar erros.<\/p><p class=\"wp-block-paragraph\">Se voc&ecirc; &eacute; um cliente novo, abra a p&aacute;gina do <a href=\"\/pt\/vps\/docker\/hermes-workspace\" target=\"_blank\" rel=\"noreferrer noopener\">template do Hermes Workspace<\/a> e escolha seu plano, per&iacute;odo de cobran&ccedil;a e localiza&ccedil;&atilde;o do servidor. Depois de concluir a compra, insira uma senha para o espa&ccedil;o de trabalho e uma chave de API.<\/p><p class=\"wp-block-paragraph\">A instala&ccedil;&atilde;o leva cerca de cinco minutos. Quando terminar, o sistema te redireciona para a p&aacute;gina do <strong>Gerenciador Docker<\/strong>. L&aacute;, clica em <strong>Abrir<\/strong> na coluna <strong>Acesso<\/strong> para entrar na interface web.<\/p><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca0896f77a\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca0896f77a\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/fi-7ddb967e-a26f-41af-bbef-5352439a5486-1.jpg\/w=1024,h=1024,fit=scale-down\" alt='Lista de projetos do Docker Manager com o link \"Abrir\" do hermes-workspace exibido.' class=\"wp-image-57269\" title=\"hpanel-vps-docker-manager-hermes-workspace-open-link-highlighted\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p class=\"wp-block-paragraph\">Se voc&ecirc; j&aacute; tem um VPS da Hostinger, tamb&eacute;m pode instalar o template Hermes Workspace pelo hPanel.<\/p><p><div class=\"announcement-block announcement-block--important\">\n            <span class=\"announcement-block__heading\">\n                <svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\">\n                    <path fill-rule=\"evenodd\" clip-rule=\"evenodd\"\n                          d=\"M12 22.5C17.799 22.5 22.5 17.799 22.5 12C22.5 6.20101 17.799 1.5 12 1.5C6.20101 1.5 1.5 6.20101 1.5 12C1.5 17.799 6.20101 22.5 12 22.5ZM13.637 7.65198C13.637 6.74791 12.9041 6.01501 12 6.01501C11.0959 6.01501 10.363 6.74791 10.363 7.65198C10.5335 9.53749 10.875 13.383 10.875 13.383C10.875 14.0043 11.3787 14.508 12 14.508C12.6213 14.508 13.125 14.0043 13.125 13.383V13.38L13.637 7.65198ZM11.9927 15.714C11.3714 15.714 10.8677 16.2177 10.8677 16.839C10.8677 17.4603 11.3714 17.964 11.9927 17.964H12.0073C12.6286 17.964 13.1323 17.4603 13.1323 16.839C13.1323 16.2177 12.6286 15.714 12.0073 15.714H11.9927Z\"\n                          fill=\"#FEA419\"\/>\n                <\/svg>\n                Important\n            <\/span>\n            <p class=\"announcement-block__content\">\n                <strong>Importante!<\/strong> A altera&ccedil;&atilde;o do sistema operacional apaga todos os dados do servidor, ent&atilde;o fa&ccedil;a um <a href=\"\/br\/support\/1583232-como-fazer-backup-ou-restaurar-um-servidor-vps-hostinger\/\">backup dos seus arquivos<\/a> e configura&ccedil;&otilde;es antes.\n            <\/p><\/div>\n\n\n\n<\/p><ol class=\"wp-block-list\">\n<li>V&aacute; para <strong>hPanel &rarr; VPS &rarr; Gerenciar &rarr; SO e Painel &rarr; Sistema Operacional<\/strong>.<\/li>\n\n\n\n<li>Na se&ccedil;&atilde;o <strong>Alterar SO<\/strong>, procure por Hermes Workspace e selecione-o.<\/li>\n<\/ol><div class=\"wp-block-image\"><figure data-wp-context='{\"imageId\":\"6a6ca08971a3e\"}' data-wp-interactive=\"core\/image\" data-wp-key=\"6a6ca08971a3e\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2026\/07\/fi-fa640d21-94cd-44e5-9b59-68e196faa59f.jpg\/w=1024,h=1024,fit=scale-down\" alt=\"Tela de altera&ccedil;&atilde;o de SO do hPanel com o template Docker do Hermes Workspace selecionado.\" class=\"wp-image-57271\" title=\"hpanel-vps-change-os-docker-application-hermes-workspace-highlighted\"><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" data-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on--click=\"actions.showLightbox\" data-wp-style--right=\"state.thisImage.buttonRight\" data-wp-style--top=\"state.thisImage.buttonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><ol start=\"3\" class=\"wp-block-list\">\n<li>Insira uma senha para o workspace e uma chave de API do seu provedor preferido.<\/li>\n\n\n\n<li>Clique em <strong>Pr&oacute;ximo<\/strong> &rarr; <strong>Implantar<\/strong>.<\/li>\n<\/ol><p class=\"wp-block-paragraph\">Quando a implanta&ccedil;&atilde;o terminar, v&aacute; at&eacute; <strong>Gerenciador Docker<\/strong> &rarr; <strong>Projetos<\/strong> e clique em <strong>Abrir<\/strong> para acessar a interface web do espa&ccedil;o de trabalho.<\/p><figure class=\"wp-block-image size-large\"><a href=\"\/pt\/alojamento-vps\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1024,h=1024,fit=scale-down\" alt=\"\" class=\"wp-image-32923\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=768,fit=scale-down 768w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/26\/2023\/02\/BR-VPS-hosting_in-text-banner-1.png\/w=1536,fit=scale-down 1536w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure><h2 class=\"wp-block-heading\" id=\"h-erros-comuns-na-configuracao-do-hermes-workspace\">Erros comuns na configura&ccedil;&atilde;o do Hermes Workspace<\/h2><p class=\"wp-block-paragraph\">A maioria dos erros de configura&ccedil;&atilde;o do Hermes Workspace tem causas recorrentes, <strong>como API desativada, chave do gateway ausente, painel n&atilde;o iniciado ou vers&atilde;o desatualizada do agente<\/strong>.<\/p><ul class=\"wp-block-list\">\n<li><strong>A API HTTP do gateway est&aacute; desativada.<\/strong> O erro &ldquo;N&atilde;o foi poss&iacute;vel acessar o gateway do Hermes nas portas 8645, 8642 ou 8643&rdquo; significa que o workspace n&atilde;o consegue acessar a API HTTP do gateway. Isso acontece quando o gateway est&aacute; rodando, mas funcionando apenas com plataformas de mensagens, com a API HTTP desativada. Adicione <strong>API_SERVER_ENABLED=true<\/strong> ao <strong>~\/.hermes\/.env<\/strong> e, em seguida, reinicie o gateway com <strong>pkill -f &ldquo;hermes gateway&rdquo;<\/strong> e <strong>hermes gateway run<\/strong>.<\/li>\n\n\n\n<li><strong>Chave do servidor de API ausente.<\/strong> O erro &ldquo;API_SERVER_KEY &eacute; obrigat&oacute;ria para o servidor de API, incluindo liga&ccedil;&otilde;es apenas para loopback em 127.0.0.1&rdquo; significa que o gateway se recusa a iniciar sua API HTTP. Isso acontece quando <strong>API_SERVER_KEY<\/strong> n&atilde;o est&aacute; definida, j&aacute; que o gateway exige essa chave inclusive em uma configura&ccedil;&atilde;o local. Gere uma com <strong>openssl rand -hex 32<\/strong>, adicione-a como <strong>API_SERVER_KEY<\/strong> no arquivo <strong>~\/.hermes\/.env<\/strong> e defina o mesmo valor como <strong>HERMES_API_TOKEN<\/strong> no arquivo <strong>~\/hermes-workspace\/.env<\/strong>.<\/li>\n\n\n\n<li><strong>O painel n&atilde;o est&aacute; funcionando.<\/strong> A linha de log &ldquo;mode=portable with missing=[&hellip;dashboard]&rdquo; significa que o workspace voltou para o modo port&aacute;til, onde sess&otilde;es, habilidades, mem&oacute;ria e tarefas n&atilde;o est&atilde;o dispon&iacute;veis. Isso acontece quando o painel n&atilde;o est&aacute; rodando na porta <strong>9119<\/strong>, geralmente porque o comando de inicializa&ccedil;&atilde;o pulou essa etapa. Pare os servi&ccedil;os em execu&ccedil;&atilde;o com <strong>Ctrl+C<\/strong> e, depois, inicie os tr&ecirc;s juntos com <strong>npx concurrently<\/strong> para que o Workspace seja iniciado com o painel e saia do modo port&aacute;til.<\/li>\n\n\n\n<li><strong>A lista de permiss&otilde;es de mensagens n&atilde;o est&aacute; definida.<\/strong> O aviso &ldquo;Nenhuma lista de permiss&otilde;es de usu&aacute;rios configurada&rdquo; significa que o agente bloqueia mensagens de usu&aacute;rios em qualquer plataforma conectada. Isso acontece quando uma plataforma de mensagens como o Telegram ou o Discord &eacute; ativada sem uma lista de usu&aacute;rios permitidos. Adicione <strong>GATEWAY_ALLOW_ALL_USERS=true<\/strong> ao arquivo <strong>~\/.hermes\/.env<\/strong> para permitir o acesso de todos os usu&aacute;rios, ou defina listas de permiss&otilde;es por plataforma para limitar quem pode acess&aacute;-la.<\/li>\n\n\n\n<li><strong>O Hermes Agent est&aacute; desatualizado.<\/strong> A linha de log &ldquo;missing=[chatCompletions, models, streaming, &hellip;]&rdquo; significa que o workspace n&atilde;o consegue encontrar os endpoints esperados, mesmo que o gateway responda. Isso acontece quando o Hermes Agent instalado &eacute; mais antigo que o espa&ccedil;o de trabalho, ent&atilde;o o agente n&atilde;o disponibiliza esses endpoints. Para uma instala&ccedil;&atilde;o via <strong>git<\/strong>, atualize o agente com <strong>cd ~\/hermes-agent &amp;&amp; git pull &amp;&amp; uv pip install -e .<\/strong> Para uma instala&ccedil;&atilde;o via PyPI, execute um pip upgrade. Depois, reinicie o gateway com hermes gateway run.<\/li>\n<\/ul><h2 class=\"wp-block-heading\" id=\"h-quanto-tempo-leva-para-configurar-o-hermes-workspace\">Quanto tempo leva para configurar o Hermes Workspace?<\/h2><p class=\"wp-block-paragraph\">A configura&ccedil;&atilde;o do Hermes Workspace leva cerca de <strong>15 a 30 minutos<\/strong> do in&iacute;cio ao fim, dependendo se voc&ecirc; est&aacute; fazendo uma instala&ccedil;&atilde;o nova ou se j&aacute; configurou o Hermes Agent antes.<\/p><p class=\"wp-block-paragraph\">A instala&ccedil;&atilde;o do Node.js e do <strong>pnpm<\/strong> leva menos de cinco minutos. O instalador de uma linha, ent&atilde;o, baixa o workspace e o agente em cerca de cinco minutos.<\/p><p class=\"wp-block-paragraph\">Se voc&ecirc; nunca configurou o Hermes Agent antes, essa costuma ser a parte que demora mais. Leva cerca de 10 minutos, porque voc&ecirc; precisa escolher um provedor, colar uma chave de API e confirmar as configura&ccedil;&otilde;es.<\/p><p class=\"wp-block-paragraph\">Se voc&ecirc; j&aacute; instalou o Hermes Agent e s&oacute; precisa clonar o Workspace no seu ambiente atual, o processo deve levar cerca de cinco minutos.<\/p><p class=\"wp-block-paragraph\">Editar os arquivos de ambiente leva mais dois ou tr&ecirc;s minutos, e iniciar os servi&ccedil;os leva mais um ou dois minutos.<\/p><h2 class=\"wp-block-heading\" id=\"h-posso-executar-varias-instancias-do-hermes-workspace-na-mesma-maquina\">Posso executar v&aacute;rias inst&acirc;ncias do Hermes Workspace na mesma m&aacute;quina?<\/h2><p class=\"wp-block-paragraph\">Sim, voc&ecirc; pode rodar mais de uma inst&acirc;ncia do Hermes Workspace na mesma m&aacute;quina. <strong>Cada inst&acirc;ncia &eacute; uma c&oacute;pia separada, ent&atilde;o precisa de seu pr&oacute;prio gateway, painel e interface de usu&aacute;rio<\/strong>.<\/p><p class=\"wp-block-paragraph\">O problema &eacute; que dois servi&ccedil;os n&atilde;o podem compartilhar uma porta. Apenas um gateway pode usar a porta <strong>8642<\/strong>. Por isso, atribua uma porta diferente ao gateway da segunda inst&acirc;ncia e aponte seu <strong>HERMES_API_URL<\/strong> para essa porta.<\/p><p class=\"wp-block-paragraph\">Fa&ccedil;a o mesmo com a interface de usu&aacute;rio, executando-a em uma porta livre com <strong>PORT=3001 pnpm dev<\/strong>. Cada inst&acirc;ncia tamb&eacute;m mant&eacute;m sua pr&oacute;pria configura&ccedil;&atilde;o, ent&atilde;o elas n&atilde;o v&atilde;o substituir os arquivos umas das outras.<\/p><p class=\"wp-block-paragraph\">Se voc&ecirc; quiser apenas executar agentes diferentes em uma &uacute;nica inst&acirc;ncia do workspace, n&atilde;o precisa de uma segunda inst&acirc;ncia. Adicione cada um como um perfil em <strong>~\/.hermes\/profiles\/nome-do-perfil<\/strong>, onde <strong>nome-do-perfil<\/strong> &eacute; um nome que voc&ecirc; escolher. Depois, voc&ecirc; pode alternar entre os perfis pela interface do usu&aacute;rio na web.<\/p><h2 class=\"wp-block-heading\" id=\"h-proximos-passos-apos-configurar-o-hermes-workspace\">Pr&oacute;ximos passos ap&oacute;s configurar o Hermes Workspace<\/h2><p class=\"wp-block-paragraph\">Com o Hermes Workspace em execu&ccedil;&atilde;o, concentre-se nestes quatro pr&oacute;ximos passos: proteja o acesso remoto, explore o mercado de habilidades, programe tarefas aut&ocirc;nomas e instale o workspace como aplicativo.<\/p><ul class=\"wp-block-list\">\n<li><strong>Acesso remoto seguro.<\/strong> Substitua o t&uacute;nel SSH pelo Tailscale ou por um proxy reverso. O t&uacute;nel funciona apenas enquanto a sess&atilde;o do terminal permanece aberta, ent&atilde;o n&atilde;o &eacute; pr&aacute;tico para o acesso di&aacute;rio. Para o Tailscale, defina <strong>API_SERVER_HOST=0.0.0.0<\/strong> no gateway e, em seguida, atualize as URLs do gateway e do painel no arquivo de ambiente do workspace.<\/li>\n\n\n\n<li><strong>Explore o mercado de habilidades.<\/strong> <a href=\"\/pt\/tutoriais\/o-que-sao-habilidades-do-hermes-agent\/\" target=\"_blank\" rel=\"noreferrer noopener\">As habilidades do Hermes<\/a> s&atilde;o recursos reutiliz&aacute;veis que ensinam o agente a lidar com tarefas espec&iacute;ficas. Adicion&aacute;-las amplia o que o agente pode fazer, desde pesquisa at&eacute; gerenciamento de arquivos. Abra a aba <strong>Habilidades<\/strong>, navegue pelo mercado e ative aquelas que se encaixam no seu fluxo de trabalho.<\/li>\n\n\n\n<li><strong>Programe tarefas aut&ocirc;nomas.<\/strong> O agendador cron integrado executa prompts de acordo com uma programa&ccedil;&atilde;o. Esse recurso executa tarefas rotineiras, como um relat&oacute;rio di&aacute;rio ou uma verifica&ccedil;&atilde;o a cada hora, sem que voc&ecirc; precise iniciar cada execu&ccedil;&atilde;o. Defina uma tarefa e sua frequ&ecirc;ncia e, em seguida, acompanhe as execu&ccedil;&otilde;es na se&ccedil;&atilde;o <strong>Tarefas<\/strong>.<\/li>\n\n\n\n<li><strong>Instale como um aplicativo.<\/strong> Instale o espa&ccedil;o de trabalho como uma aplica&ccedil;&atilde;o web progressiva (PWA). Assim, ele abre como um aplicativo nativo no seu computador ou celular, sem precisar manter uma aba aberta no navegador. Use o &iacute;cone de instala&ccedil;&atilde;o do Chrome ou v&aacute; em Compartilhar &rarr; Adicionar &agrave; tela inicial no Safari do iOS.<\/li>\n<\/ul><p class=\"wp-block-paragraph\">Se quiser ideias sobre o que automatizar, d&ecirc; uma olhada nos <a href=\"\/pt\/tutoriais\/exemplos-de-uso-do-hermes-agent\/\" target=\"_blank\" rel=\"noreferrer noopener\">casos de uso populares do Hermes Agent<\/a> para ver como outras pessoas usam o agente.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>O Hermes Workspace &eacute; uma interface web de c&oacute;digo aberto para o Hermes Agent, um agente de IA que se aprimora sozinho, desenvolvido pela Nous Research. Ele re&uacute;ne o chat do agente, a mem&oacute;ria persistente, o mercado de habilidades, o terminal e a orquestra&ccedil;&atilde;o multiagente em um &uacute;nico painel auto-hospedado, que voc&ecirc; pode acessar de [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"\/pt\/tutoriais\/como-configurar-o-hermes-workspace\/\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":433,"featured_media":50604,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"rank_math_title":"Como configurar o Hermes Workspace: passo a passo","rank_math_description":"Aprenda a como configurar o Hermes Workspace em uma VPS, ajustar gateway e dashboard e acessar o centro de agentes de IA.","rank_math_focus_keyword":"como configurar o Hermes Workspace","footnotes":""},"categories":[4915],"tags":[],"class_list":["post-50603","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-vps"],"hreflangs":[{"locale":"pt-BR","link":"https:\/\/www.hostinger.com\/br\/tutoriais\/como-configurar-o-hermes-workspace\/","default":1},{"locale":"pt-PT","link":"https:\/\/www.hostinger.com\/pt\/tutoriais\/como-configurar-o-hermes-workspace\/","default":0}],"acf":[],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts\/50603","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/users\/433"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/comments?post=50603"}],"version-history":[{"count":0,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/posts\/50603\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/media\/50604"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/media?parent=50603"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/categories?post=50603"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/pt\/tutoriais\/wp-json\/wp\/v2\/tags?post=50603"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}