J_ JAZZ AUTOMATIONS
MANUAL DE CAMPO / Nº 001 Abrir apresentação
JAZZ AUTOMATIONS / MANUAL DE CAMPO Nº 001
▶ ABRIR APRESENTAÇÃO (slides) 25 SLIDES / SETAS PARA NAVEGAR / F: TELA CHEIA

SEU LAPTOP
PODE DORMIR.
A NAIMA, NÃO.

Uma agente viva na VPS Oracle.
Você no Telegram. O SSH dentro da tailnet.

naima@oracle:~ DEMO / ARQUITETURA FINAL

$ ssh opc@100.83.142.44

Conexão pela tailnet. Porta 22 pública fechada.

$ systemctl --user is-active hermes-gateway

active _

A IDEIA CENTRAL

O LLM fala. O harness dá ferramentas para agir.
O servidor mantém a Naima acordada.

Veja quem construiu tudo: o agente no terminal

Um relato de implementação, com os erros que apareceram e os ajustes que fizeram funcionar. Os comandos são exemplos para você adaptar à sua VPS.

01 Criar a casa 02 Fechar a rede 03 Dar vida à Naima
CAP 01 — VPS

O laptop dorme.
A Naima também.

O agente no laptop para quando você fecha a tampa ou a máquina dorme. Na VPS, ela fica viva 24h e você conversa com ela de qualquer lugar pelo Telegram.

NO LAPTOP

Fechou a tampa?

O processo depende da sua máquina acordada, conectada e disponível.

agente: offline
NA VPS

Uma casa sempre ligada.

O runtime fica no servidor. Seu celular é a interface, via Telegram.

agente: disponível 24h

A brisa dos servidores

[O QUE É]
Um servidor é um computador que fica ligado 24/7, num datacenter com energia e rede redundantes. Nesta demo, ele tem IP público: um endereço para ser alcançado na internet.
[POR QUE]
A agente mora onde estão seu processo, arquivos e memória. No laptop, tampa fechada interrompe o trabalho; no servidor, o celular pode ser só a interface.
[PEGADINHA]
24/7 é o objetivo operacional, não uma garantia mágica. Quedas, reinícios e falhas existem: systemd reinicia o processo; backups preservam o estado.
VPS

Um pedaço virtual

Você aluga uma máquina virtual dentro de um computador físico compartilhado. Tem sistema e recursos próprios para administrar.

CLOUD

O conjunto de serviços

Máquinas virtuais, rede, discos e APIs sob demanda. A OCI é uma cloud; a VPS da demo é uma VM dentro dela.

DEDICADO

A máquina inteira

O hardware físico fica reservado para você. Dá mais controle, costuma custar mais e ainda exige manutenção.

CAP 02 — ORACLE

Oracle: a parte com pegadinhas.

Crie uma conta trial com créditos. Nesta demo, usamos Oracle Linux 9.8 e o shape AMD VM.Standard.E5.Flex.

CLI de agentes: intenção vira execução

[O QUE É]
CLI é interface de linha de comando: o terminal. Devin CLI, Codex CLI e jazz-cli são agentes que usam esse ambiente para ler arquivos, executar ferramentas e operar máquinas inteiras.
[POR QUE]
No vídeo, é o Devin CLI que constrói tudo: provisiona a OCI, configura a rede e instala a Naima. O humano descreve a intenção; o agente executa e observa o resultado.
[PEGADINHA]
O agente herda as permissões das ferramentas e credenciais disponíveis. Um comando pode gerar custo ou alterar uma máquina: escopo e revisão continuam necessários.
Humano
dá intenção
→ Agente CLI
executa tools
→ Máquina real
retorna evidência

OCI Agent Skills: o manual que o agente carrega

[O QUE É]
Um pacote de cerca de 30 skills de Oracle Cloud no recorte da palestra. Os arquivos SKILL.md ensinam compute, network, quotas, custo e capacity ao agente. O catálogo pode crescer entre versões.
[POR QUE]
Você entrega o link do GitHub ao agente e pede para instalar. O SKILL.md orienta o restante; o agente passa a ter instruções específicas para trabalhar na OCI.
[PEGADINHA]
Skill é conhecimento carregável. Não concede acesso à conta: OCI CLI, autenticação e políticas IAM ainda precisam estar configuradas. Quota disponível também não significa capacidade física disponível.
“Instale as skills de https://github.com/jazzautomations/oci-agent-skills. Leia as instruções do repositório e confira quais skills ficaram disponíveis.”
Abrir OCI Agent Skills no GitHub
Devin CLI lista as skills OCI instaladas: o agente já tem o manual da infraestrutura.
[FRAME] assets/frames/p1-15.jpg Devin CLI lista as skills OCI instaladas: o agente já tem o manual da infraestrutura. Ampliar frame
AMD / E5.Flex

Pago com créditos

Funciona no trial. O teto escondido observado foi de aproximadamente 6 OCPU / 96 GB por instância .

ARM / A1.Flex

Grátis, sem capacidade

Nas tentativas da demo em us-chicago-1 , retornou sempre OUT_OF_HOST_CAPACITY .

Primeiro no console, depois na CLI

  1. Entre em cloud.oracle.com e selecione us-chicago-1 .
  2. Em Networking, crie VCN 10.0.0.0/16 , Internet Gateway e rota 0.0.0.0/0 → IGW .
  3. Crie subnet pública 10.0.0.0/24 . Em Compute, escolha Oracle Linux 9.8, E5.Flex e sua chave SSH.
  4. Para o primeiro acesso, permita TCP/22 temporariamente, de preferência apenas do seu IP público ( SEU_IP/32 ). Essa regra será removida no capítulo 4.

Os comandos abaixo são equivalentes para uma rede nova e dedicada à demo . Substitua os campos marcados. A CLI precisa estar autenticada ( oci setup config ) ou use o Cloud Shell.

[COMANDO] OCI CLI · rede
# No seu computador ou no OCI Cloud Shell, com OCI CLI autenticada.
# OCID = identificador do recurso. Copie o do seu compartment no console.
export OCI_CLI_REGION=us-chicago-1
export COMPARTMENT_ID='ocid1.compartment.oc1..SUBSTITUA'

# 1. VCN: a rede privada que contém a VPS.
VCN_ID=$(oci network vcn create \
  --compartment-id "$COMPARTMENT_ID" \
  --cidr-block 10.0.0.0/16 --display-name naima-vcn \
  --query 'data.id' --raw-output)

# 2. Internet Gateway: saída da VCN para a internet.
IGW_ID=$(oci network internet-gateway create \
  --compartment-id "$COMPARTMENT_ID" --vcn-id "$VCN_ID" \
  --is-enabled true --display-name naima-igw \
  --query 'data.id' --raw-output)

# 3. Descubra a tabela de rotas padrão da VCN.
RT_ID=$(oci network vcn get --vcn-id "$VCN_ID" \
  --query 'data."default-route-table-id"' --raw-output)

# 4. Tudo que não for local (0.0.0.0/0) sai pelo IGW.
oci network route-table update --rt-id "$RT_ID" \
  --route-rules "[{\"destination\":\"0.0.0.0/0\",\"destinationType\":\"CIDR_BLOCK\",\"networkEntityId\":\"$IGW_ID\"}]"

# 5. Subnet pública: permite atribuir IP público à instância.
SUBNET_ID=$(oci network subnet create \
  --compartment-id "$COMPARTMENT_ID" --vcn-id "$VCN_ID" \
  --cidr-block 10.0.0.0/24 --route-table-id "$RT_ID" \
  --prohibit-public-ip-on-vnic false --display-name naima-public \
  --query 'data.id' --raw-output)
[COMANDO] OCI CLI · instância
# Na MESMA sessão da CLI: escolha AD e imagem da região.
oci iam availability-domain list --compartment-id "$COMPARTMENT_ID"
oci compute image list --compartment-id "$COMPARTMENT_ID" \
  --operating-system 'Oracle Linux' --operating-system-version '9.8' \
  --shape VM.Standard.E5.Flex --all

# Copie o nome do AD e o OCID da imagem Oracle Linux 9.8 x86.
export AD='SUBSTITUA_PELO_NOME_DO_AD'
export IMAGE_ID='ocid1.image.oc1.us-chicago-1.SUBSTITUA'

# Exemplo conservador: 1 OCPU / 16 GB, shape PAGO usando créditos.
# A chave pública deve existir no computador que executa a CLI.
oci compute instance launch \
  --compartment-id "$COMPARTMENT_ID" --availability-domain "$AD" \
  --display-name naima-vps --shape VM.Standard.E5.Flex \
  --shape-config '{"ocpus":1,"memoryInGBs":16}' \
  --image-id "$IMAGE_ID" --subnet-id "$SUBNET_ID" \
  --assign-public-ip true --ssh-authorized-keys-file ~/.ssh/id_ed25519.pub \
  --wait-for-state RUNNING

Espere a instância ficar RUNNING ; copie o IP público em Compute → Instance → Primary VNIC. Acesse com ssh opc@IP_PUBLICO . Ainda não feche a porta pública.

O agente registra o desenho da rede e o plano da arquitetura durante o provisionamento.
[FRAME] assets/frames/p1-120.jpg O agente registra o desenho da rede e o plano da arquitetura durante o provisionamento. Ampliar frame
CAP 03 — TAILNET

Sua porta de entrada é a tailnet.

Tailscale cria uma rede privada entre os seus dispositivos. Instale na VPS e também no computador de onde você fará a administração.

[O QUE É]
A tailnet é sua rede mesh privada com túneis WireGuard entre dispositivos autenticados. Cada nó recebe um IP estável 100.x dentro da faixa 100.64.0.0/10 .
[POR QUE]
Seu laptop, celular e VPS se encontram mesmo em redes diferentes. O MagicDNS permite usar nomes de máquinas em vez de decorar endereços.
[PEGADINHA]
O IP é estável enquanto o nó permanece registrado; remover e cadastrar novamente pode alterá-lo. Estar na mesma tailnet não substitui políticas de acesso.
[COMANDO] VPS · usuário opc
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
# Abra o link exibido e autorize esta máquina na sua conta.
tailscale ip -4
tailscale status

Se a tailnet exigir aprovação de dispositivos, aprove a VPS no admin console do Tailscale . O nó ganha um endereço 100.x . Na demo: 100.83.142.44 .

[COMANDO] Seu computador · conectado à mesma tailnet
# Abra uma NOVA sessão e confirme o acesso antes do lockdown.
ssh opc@100.83.142.44
# Use o IP retornado por tailscale ip -4 na SUA VPS.
O terminal prepara o acesso e o fluxo de login do Tailscale; a autorização continua no navegador.
[FRAME] assets/frames/p1-200.jpg O terminal prepara o acesso e o fluxo de login do Tailscale; a autorização continua no navegador. Ampliar frame
Login concluído no navegador: a identidade autoriza a entrada do dispositivo na tailnet.
[FRAME] assets/frames/p1-300.jpg Login concluído no navegador: a identidade autoriza a entrada do dispositivo na tailnet. Ampliar frame

Direto quando dá. Relay quando precisa.

[O QUE É]
P2P liga os dispositivos diretamente. Se NAT ou firewall impedirem, o DERP retransmite os pacotes já criptografados, sem ler seu conteúdo.
[POR QUE]
O acesso pode funcionar sem redirecionar portas no roteador. tailscale status mostra direct ou relay; tailscale ping NOME_DA_VPS ajuda no diagnóstico.
[PEGADINHA]
Relay pode aumentar latência e reduzir vazão. Liberar UDP/41641 ajuda conexões diretas, mas não é exigência universal: saída HTTPS permite alcançar DERP.
POLÍTICA DE ACESSO

ACL + tags

[O QUE É]
ACLs definem quem pode alcançar qual serviço; tags, como tag:server , agrupam máquinas por função.
[POR QUE]
Você pode permitir administração só para o dono, sem dar acesso geral à rede.
[PEGADINHA]
Entrar na tailnet não cria uma política restritiva automaticamente. Revise regras amplas e quem pode atribuir tags.
IDENTIDADE NO SSH

Tailscale SSH

[O QUE É]
É um recurso opcional que autentica SSH pela identidade e política da tailnet.
[POR QUE]
Centraliza quem pode entrar e com qual usuário do sistema, sem distribuir chaves SSH tradicionais.
[PEGADINHA]
Precisa ser habilitado e ter política SSH. A demo usa SSH comum sobre Tailscale, com a chave da VPS; os dois modelos são diferentes.

Serve por dentro. Funnel para o mundo.

[O QUE É]
tailscale serve disponibiliza um serviço à tailnet. tailscale funnel publica um serviço local na internet por um endereço HTTPS.
[POR QUE]
O Funnel é usado para servir este próprio site no desenho da demo, com proxy Vercel à frente. Não é preciso abrir portas de entrada TCP/80 ou TCP/443 na VPS.
[PEGADINHA]
Funnel torna o serviço escolhido público. Serve continua privado; a política da tailnet controla seu acesso. Funnel requer configuração e permissão próprias, e não publica o SSH.

PRIVADO Dispositivo da tailnet → Serve → serviço local

PÚBLICO Internet → Vercel → Funnel → site local

Para aprofundar: tailnet e WireGuard , MagicDNS , Serve , Funnel , ACLs e Tailscale SSH .

CAP 04 — SSH + LOCKDOWN

Fechar pra rua. Manter pra você.

Na security list da subnet, remova o ingress TCP/22 da internet. Ficam somente UDP/41641, usado pelo WireGuard do Tailscale, e ICMP.

SSH e porta 22, sem mistério

[O QUE É]
SSH é um shell remoto criptografado: você digita aqui e o computador de lá executa. Uma porta é a caixa de correio numerada de um IP; o SSH costuma atender na TCP/22 .
[POR QUE]
Com chave pública/privada, a pública pode ficar no servidor; a privada fica com você e prova sua identidade. Senha é outro método de autenticação, mais exposto a tentativas automatizadas quando fraca ou reutilizada.
[PEGADINHA]
Porta 22 aberta para a internet recebe varreduras e brute force do mundo inteiro. Chaves fortes ajudam; retirar o SSH da rua reduz a superfície de ataque. Trocar só o número da porta não resolve.
INTERNET → IP PÚBLICO :22 → DROP O SSH não atende a rua.
DONO → TAILNET 100.x :22 → OK Dark host para administração: acesso privado continua.
ANTES / ENTRADA

TCP 22 · internet → SSH

UDP 41641 · Tailscale

ICMP · diagnóstico de rede

DEPOIS / ENTRADA

TCP 22 · internet → SSH

UDP 41641 · Tailscale

ICMP · diagnóstico de rede

[COMANDO] OCI CLI · lockdown
# Na sessão OCI CLI do capítulo 2, recupere a security list padrão.
SL_ID=$(oci network vcn get --vcn-id "$VCN_ID" \
  --query 'data."default-security-list-id"' --raw-output)

# Confira e guarde localmente a configuração antes de substituir ingress.
oci network security-list get --security-list-id "$SL_ID" > security-list-antes.json

# Só faça isso DEPOIS de testar uma nova sessão SSH pela tailnet.
# A lista abaixo SUBSTITUI todas as regras de entrada desta security list.
# Protocolo 17 = UDP. Protocolo 1 = ICMP.
oci network security-list update --security-list-id "$SL_ID" \
  --ingress-security-rules '[
    {"source":"0.0.0.0/0","sourceType":"CIDR_BLOCK","protocol":"17","isStateless":false,"udpOptions":{"destinationPortRange":{"min":41641,"max":41641}}},
    {"source":"0.0.0.0/0","sourceType":"CIDR_BLOCK","protocol":"1","isStateless":false,"icmpOptions":{"type":3,"code":4}},
    {"source":"10.0.0.0/16","sourceType":"CIDR_BLOCK","protocol":"1","isStateless":false,"icmpOptions":{"type":3}}
  ]'
# Egress não é alterado: mantenha a saída permitida.

O exemplo mantém ICMP tipo 3/código 4 da internet e tipo 3 dentro da VCN, para sinalização de rede. Não abre ping público. No console: Networking → VCN → Subnet → Security Lists → Ingress Rules.

[COMANDO] Seu computador · a prova
# Substitua pelo IP público real da sua VPS.
ssh -o ConnectTimeout=8 opc@IP_PUBLICO
# Esperado: Connection timed out

ssh -o ConnectTimeout=8 opc@100.83.142.44
# Esperado: sessão SSH aberta pela tailnet.
Autorização do dispositivo concluída no Tailscale: etapa necessária antes de fechar o SSH público.
[FRAME] assets/frames/p1-360.jpg Autorização do dispositivo concluída no Tailscale: etapa necessária antes de fechar o SSH público. Ampliar frame
Resumo ao vivo do lockdown e diagrama: TCP/22 público em DROP; SSH pela tailnet funcionando.
[FRAME] assets/frames/p1-430.jpg Resumo ao vivo do lockdown e diagrama: TCP/22 público em DROP; SSH pela tailnet funcionando. Ampliar frame

“Dark host” aqui descreve o SSH invisível à rua; a demo ainda mantém IP público, UDP/41641 e ICMP selecionado.

CAP 05 — HARNESS + HERMES

Hermes é o motor.

[SEM JARGÃO] LLM é o modelo de linguagem: o programa que interpreta seu pedido e gera texto. Runtime é o software em execução; harness conecta esse modelo às ferramentas.

Harness: o conceito central da palestra

[O QUE É]
O LLM sozinho só fala. Harness é a moldura que o faz agir : ferramentas, loop de execução, permissões, regras, memória e skills.
[POR QUE]
O modelo decide o próximo passo; o harness chama terminal, arquivos ou browser, devolve a observação e repete o ciclo. É assim que uma intenção vira trabalho verificável.
[PEGADINHA]
Ter ferramentas não significa poder fazer tudo. O runtime deve aplicar permissões; SOUL.md e AGENTS.md orientam o comportamento, mas texto sozinho não é uma barreira de segurança.
HERMES / HARNESS DA NAIMA
terminal + arquivos + browser memória + skills permissões + SOUL.md + AGENTS.md
HERMES

O harness

Conecta o modelo às ferramentas, mantém o loop e integra os canais da Naima.

SOUL + AGENTS

Personalidade + regras

SOUL.md dá voz e identidade. AGENTS.md define limites e modo de trabalho.

MEMÓRIA + SKILLS

Continuidade + método

Memória guarda contexto entre tarefas. Skills carregam conhecimento específico quando necessário.

Hermes Agent é o runtime open source da Nous Research. Ele conecta modelo, ferramentas, skills e canais de mensagem.

Fonte oficial: NousResearch/hermes-agent . Nesta instalação ele roda como root , em /usr/local/lib/hermes-agent . A casa da agente é HERMES_HOME=/root/.hermes .

[COMANDO] VPS · instalar runtime
# Na VPS, entre como root. Oracle Linux usa dnf, não apt.
sudo -i
dnf install -y git curl gcc gcc-c++ make python3 python3-pip
curl -LsSf https://astral.sh/uv/install.sh | sh
export PATH="/root/.local/bin:$PATH"
export HERMES_HOME=/root/.hermes

# Runtime open source oficial.
git clone https://github.com/NousResearch/hermes-agent.git /usr/local/lib/hermes-agent
cd /usr/local/lib/hermes-agent
export UV_NO_CONFIG=1 HERMES_SETUP_NONINTERACTIVE=1
bash setup-hermes.sh

# O setup deve produzir venv/bin/hermes. Confira antes do wrapper.
test -x /usr/local/lib/hermes-agent/venv/bin/hermes

cat > /usr/local/bin/hermes <<'WRAPPER'
#!/usr/bin/env bash
unset PYTHONPATH PYTHONHOME
export HERMES_HOME=/root/.hermes
exec /usr/local/lib/hermes-agent/venv/bin/hermes "$@"
WRAPPER
chmod +x /usr/local/bin/hermes
mkdir -p /root/.hermes
hermes --version
Instalação real: o agente prepara o runtime Hermes e identifica ajustes do ambiente.
[FRAME] assets/frames/p2-60.jpg Instalação real: o agente prepara o runtime Hermes e identifica ajustes do ambiente. Ampliar frame
CAP 06 — PACOTE NAIMA

Naima é o pacote de identidade.

O agente de código lê naima-hermes/LEIA-ME-CLAUDE.md, no repositório público, e faz a instalação guiada. Você fornece os dados do dono e autentica sua própria conta.

~/.hermes/
├── config.yaml modelo, canal e execução
├── .env token + ID do dono · modo 600
├── SOUL.md quem é a Naima
├── AGENTS.md limites de atuação
└── skills/jazz/ 9 arquivos SKILL.md

No Telegram, crie o bot com @BotFather ( /newbot ) e obtenha seu ID numérico de usuário. O token identifica o bot; TELEGRAM_ALLOWED_USERS restringe quem pode conversar com ele.

[COMANDO] VPS · instalar o pacote Naima
# Na VPS, como root.
cd /root
git clone https://github.com/jazzautomations/naima-completo.git
cd /root/naima-completo/naima-hermes

# O agente de código lê este roteiro para conduzir a instalação.
less LEIA-ME-CLAUDE.md

# Configuração + identidade + regras.
install -m 600 template/.env /root/.hermes/.env
cp template/config.yaml template/SOUL.md template/AGENTS.md /root/.hermes/

# As nove skills já nascem instaladas.
mkdir -p /root/.hermes/skills
cp -r skills/jazz /root/.hermes/skills/
find /root/.hermes/skills/jazz -name SKILL.md | wc -l
# Esperado: 9

# Edite localmente. Não cole os valores em log ou no projetor.
vi /root/.hermes/.env
# Preencha TELEGRAM_BOT_TOKEN e TELEGRAM_ALLOWED_USERS.
chmod 600 /root/.hermes/.env
[COMANDO] Trecho de config.yaml · mescle no arquivo existente
approvals:
  mode: "off"
O agente lê o LEIA-ME e conduz a instalação do pacote Naima.
[FRAME] assets/frames/p2-180.jpg O agente lê o LEIA-ME e conduz a instalação do pacote Naima. Ampliar frame
Configuração e validação remotas por SSH durante a instalação da Naima.
[FRAME] assets/frames/p2-260.jpg Configuração e validação remotas por SSH durante a instalação da Naima. Ampliar frame
CAP 07 — OAUTH CHATGPT

Login com ChatGPT. Sem API key.

Na VPS, inicie o device flow. O dono conclui o login no próprio navegador com uma conta ChatGPT Plus ou Pro.

[SEM JARGÃO] OAuth é a autorização para um programa acessar sua conta sem receber sua senha. No device flow, você usa um link e um código para concluir essa autorização em outro aparelho.

[COMANDO] VPS · OAuth openai-codex
export HERMES_HOME=/root/.hermes
hermes auth add openai-codex
# O Hermes exibe um link e um código temporário.
# Abra https://auth.openai.com/codex/device no SEU navegador.
# Entre na conta ChatGPT Plus/Pro e informe o código.

# Verifique a existência, sem imprimir as credenciais.
test -s /root/.hermes/auth.json && echo 'OAuth gravado'
chmod 600 /root/.hermes/auth.json
  1. O Hermes mostra o código de dispositivo.
  2. O dono abre auth.openai.com/codex/device , entra e autoriza.
  3. As credenciais ficam em /root/.hermes/auth.json . Não compartilhe esse arquivo.
[COMANDO] Trecho de config.yaml · modelo da demo
model:
  provider: openai-codex
  default: gpt-5.6-luna

Sem chave de API e sem cobrança de API neste fluxo. A conta Plus/Pro continua tendo assinatura e limites de uso. Aqui, o modelo e o resultado descrevem a configuração da demo.

CAP 08 — SYSTEMD + TELEGRAM

Sai do SSH. Continua no Telegram.

O systemd cuida do processo. O gateway usa polling: consulta o Telegram pela saída da VPS. Você não precisa abrir uma porta de webhook.

[SEM JARGÃO] Gateway é a ponte entre Telegram e agente. Polling é perguntar ao Telegram se chegou mensagem. Webhook faz o caminho inverso: o serviço envia um aviso a um endereço seu quando algo acontece.

[COMANDO] VPS · serviço persistente
# Na VPS, como root, a partir do pacote já clonado.
mkdir -p /root/.config/systemd/user
cp /root/naima-completo/naima-hermes/template/systemd/hermes-gateway.service \
  /root/.config/systemd/user/hermes-gateway.service

# Linger mantém o gerenciador do usuário ativo sem sessão SSH.
loginctl enable-linger root
systemctl start user@0.service
export XDG_RUNTIME_DIR=/run/user/0
systemctl --user daemon-reload
systemctl --user enable --now hermes-gateway.service
systemctl --user is-active hermes-gateway.service
# Esperado: active

# Diagnóstico local: não projete logs que contenham dados privados.
journalctl --user -u hermes-gateway.service -n 40 --no-pager
TESTE MANUAL · CONVERSA ILUSTRATIVA

Dono: Naima, está online?

Naima: Estou aqui. Pode mandar.

O dono inicia a conversa com /start ou uma mensagem; a resposta confirma o fluxo.

E mensagem de voz?

O faster-whisper transcreve localmente. Instale no mesmo venv do Hermes e mescle este trecho no config.yaml:

[COMANDO] VPS · transcrição local
/root/.local/bin/uv pip install \
  --python /usr/local/lib/hermes-agent/venv/bin/python faster-whisper
[COMANDO] Trecho de config.yaml · áudio
stt:
  enabled: true
  provider: local
  local:
    model: base
[COMANDO] VPS · remendo de compatibilidade do áudio
sed -i 's/, metadata_errors="ignore"//' \
  /usr/local/lib/hermes-agent/venv/lib/python*/site-packages/faster_whisper/transcribe.py
export XDG_RUNTIME_DIR=/run/user/0
systemctl --user restart hermes-gateway.service

O primeiro uso baixa o modelo local. Envie um áudio curto ao bot e confirme a transcrição; se falhar, journalctl --user -u hermes-gateway mostra o motivo. Detalhe: o faster-whisper precisa estar no Python do Hermes (o venv de /usr/local/lib/hermes-agent), não no Python do sistema.

Teste de fogo: sair do roteiro e conferir

Teste de fogo na execução real: o agente registra o resultado 100/100.
[FRAME] assets/frames/p2-340.jpg Teste de fogo na execução real: o agente registra o resultado 100/100. Ampliar frame
CAP 09 — SKILLS + TIME

Não é só uma personalidade.
É um time com método.

As nove skills já vêm no pacote: quatro papéis de subagentes e cinco métodos de trabalho.

JU

Juliana

Operação e design

juliana-ops
CD

Clone do dono

SDR / comercial

clone-do-dono
PA

Paulo

Desenvolvimento

paulo-dev
JO

Jonathan

Copy

jonathan-copy

Cinco métodos instalados

  • Carrossel de Instagram
  • Landing pages
  • Propostas comerciais
  • Vídeo sanduíche
  • Conectar Instagram / Zernio
CAP 09B — COMPOSIO / TOOLS NA INTERNET

MÃOS NA MÁQUINA.
MÃOS NA INTERNET.

O harness dá mãos na máquina; o Composio dá mãos na internet.

Quando a Naima precisa agir nos apps do dono — consultar o Gmail, criar um evento no Calendar, atualizar o Notion ou escrever no Sheets — entra uma camada de integrações além do terminal local.

[O QUE É]
Composio é um hub de integrações para agentes: uma API e uma camada de autenticação unificam o acesso a centenas de apps. API é um jeito padronizado de um programa pedir ações a outro.
[POR QUE]
Em vez de montar uma integração do zero para cada app, o agente recebe tools: ferramentas que executam ações específicas, como buscar um e-mail ou criar um evento.
[AUTORIZAÇÃO]
OAuth é a tela em que o dono autoriza acesso à conta sem entregar sua senha ao agente. A integração centraliza o fluxo; cada app e conta ainda exige sua autorização e seus escopos — a lista do que pode ser lido ou alterado.
[PEGADINHA]
Uma API só não dá acesso automático a todas as contas. Escolha apps e permissões por tarefa. Esta é uma extensão possível da arquitetura; os frames anteriores mostram a demo local, sem comprovar uma instalação do Composio.

[ALTERNATIVA] MCP servers. MCP é um protocolo comum para conectar agentes a ferramentas. Um MCP server é um programa que oferece essas ferramentas ao agente; você pode usar servidores dos próprios serviços ou manter os seus.

[CATÁLOGO] ~300 apps é a referência deste briefing. O catálogo cresce: na consulta de 19/11/2026, o site oficial anuncia 1.700+ apps . Veja também autenticação e permissões por integração .

CAP 10 — ARQUITETURA + CUSTOS

A arquitetura, de ponta a ponta.

Conversa, administração e site público têm caminhos distintos. O Telegram usa o gateway; o SSH passa pela tailnet; a publicação do site usa Funnel e proxy Vercel.

Dono
  │ mensagem / áudio
  ▼
Telegram ── polling de saída ──► Gateway na VPS
                                      │
                                      ▼
                                    Hermes
                                      │
                                      ▼
                              openai-codex OAuth
                                      │
                                      ▼
                                   ChatGPT

ADMIN:  computador na tailnet ── SSH ──► 100.83.142.44
RUA:    entrada pública ──► UDP/41641 + ICMP (sem TCP/22)
SITE:   visitante ──► proxy Vercel ──► Tailscale Funnel ──► site na VPS

Rede

Tailnet 100.x para administrar. Entrada pública limitada a UDP/41641 e ICMP; saída mantida.

Identidade

Usuário autorizado no Telegram, OAuth pessoal e arquivos secretos com permissão 600.

Comportamento

AGENTS.md orienta a Naima: só o dono, sem expor segredo, confirmar exclusão e envio externo.

O custo real da demo

Créditos Oracle trial cobre o shape pago enquanto houver saldo e validade.
Sem API key OAuth usa a conta ChatGPT Plus/Pro. Sem custo de API neste fluxo.
Confira Assinatura, limites de uso e cobrança da nuvem continuam existindo.

Checklist de chegada

  • VPS ativa; SSH pela tailnet entra em uma nova sessão.
  • SSH pelo IP público dá timeout após remover TCP/22.
  • Config, identidade, .env protegido e nove skills instaladas.
  • auth.json existe; modelo gpt-5.6-luna configurado.
  • Gateway active; dono manda texto e áudio e recebe resposta.

Segurança em camadas

[O QUE É]
São barreiras complementares: transporte privado, borda da cloud, limites de atuação, armazenamento de segredos e remoção de dados sensíveis das saídas.
[POR QUE]
Se uma camada falha, as outras reduzem o estrago. A tailnet protege o caminho; ela não impede uma agente autorizada de vazar um token num log.
[PEGADINHA]
Nenhuma camada sozinha basta. Regras em linguagem natural não isolam processos; na demo, root e approvals desligados dão bastante poder ao runtime.
  1. Tailnet · transporte WireGuard + identidade + ACL/tags: quem chega à máquina.
  2. Security list · borda OCI Retira TCP/22 público; confira também NSGs e firewall do sistema.
  3. SOUL / AGENTS · atuação Só o dono; confirmar ações sensíveis. Combine com permissões reais nas tools.
  4. Cofre · segredos Guardar tokens com acesso mínimo. Na demo: .env e auth.json em modo 600; um cofre dedicado é a evolução.
  5. Redact · saída Mascarar tokens e dados pessoais antes de logs, capturas e respostas; não imprimir o segredo para depois esconder.
Telegram e diagrama final: o agente resume os caminhos de conversa, administração e publicação.
[FRAME] assets/frames/p2-400.jpg Telegram e diagrama final: o agente resume os caminhos de conversa, administração e publicação. Ampliar frame
EXECUÇÃO GRAVADA

Veja o caminho real.

Os vídeos estão nesta pasta. Nenhum player externo, nenhum embed de terceiros.

VÍDEO COMPLETO · 15min

Da VPS zerada à Naima viva

O corte integral: provisionamento Oracle, Tailscale, lockdown, instalação do pacote naima-completo, OAuth do ChatGPT e a resposta ao vivo no Telegram.

PARTE 1

VPS, Tailscale e lockdown

Provisionamento da Oracle Cloud, acesso privado e fechamento do SSH público.

PARTE 2

Instalação da Naima: Hermes, OAuth, skills e Telegram

Um prompt só e o agente faz tudo na VPS: clona o pacote, sobe o Hermes, injeta o bot, instala as dez skills, faz o OAuth do ChatGPT e deixa a agente respondendo no Telegram.

Vídeos originais sem faixa de legendas fornecida.

APÊNDICE A — SEM JARGÃO SOLTO

TRADUÇÃO DE CAMPO.

O termo aparece no terminal. A explicação fica aqui.

IP / porta
IP é o endereço de um computador na rede; porta é o número que identifica um serviço nesse endereço.
VPS / VM / cloud / OCI
VPS é um computador remoto virtual. VM é máquina virtual. Cloud é o conjunto de recursos alugados pela internet; OCI é a cloud da Oracle.
Shape / OCPU / AMD / ARM
Shape é o perfil de hardware da VM; OCPU mede capacidade de processamento na OCI. AMD x86 e ARM são famílias de processadores, que precisam de software compatível.
CLI / shell / SSH
CLI é a interface por comandos. Shell é o programa que os interpreta. SSH abre um terminal remoto com conexão criptografada.
VCN / subnet / CIDR / IGW
VCN é uma rede virtual privada na Oracle; subnet é uma divisão dela. CIDR, como /24, descreve a faixa de IPs; IGW é o portão de saída para a internet.
OCID / compartment / IAM / AD
OCID é o identificador de um recurso Oracle. Compartment agrupa recursos; IAM define identidades e permissões; AD é uma zona de datacenter dentro da região.
VNIC / security list / NSG
VNIC é a placa de rede virtual da VM. Security lists e NSGs são conjuntos de regras que permitem tráfego para recursos da rede.
Ingress / egress / firewall / lockdown
Ingress é tráfego entrando; egress é tráfego saindo. Firewall filtra esse tráfego. Lockdown é restringir os acessos que ficam abertos.
TCP / UDP / ICMP
São formas de transportar ou sinalizar dados na rede. SSH usa TCP; WireGuard usa UDP; ICMP comunica diagnósticos e erros de rede.
Tailnet / mesh / nó / WireGuard
Tailnet é a rede privada dos seus dispositivos no Tailscale. Mesh significa que eles podem se conectar entre si; nó é cada dispositivo; WireGuard criptografa os túneis.
P2P / relay / DERP / NAT
P2P é conexão direta entre dispositivos. Relay é um intermediário; DERP é o relay do Tailscale. NAT compartilha um IP externo e pode dificultar conexões diretas.
DNS / MagicDNS / ACL / tags
DNS troca nomes por endereços IP. MagicDNS faz isso na tailnet. ACL é uma regra de quem pode acessar o quê; tags agrupam máquinas por função.
Serve / Funnel / proxy / HTTPS
Serve expõe um serviço à tailnet; Funnel o publica na internet. Proxy repassa pedidos a outro servidor. HTTPS protege a conexão do navegador com criptografia.
LLM / harness / runtime / open source
LLM é o modelo que interpreta e gera texto. Harness conecta o modelo às ferramentas; runtime é o programa em execução. Open source significa código aberto para inspeção conforme sua licença.
Skill / tool / loop / subagente
Skill é um manual carregável; tool é uma ferramenta executável. Loop é repetir pensar, agir e observar. Subagente é outro agente encarregado de uma parte do trabalho.
OAuth / device flow / API key / token
OAuth é autorização sem compartilhar senha. Device flow usa um código para concluir o login em outro aparelho. API key e token são credenciais de acesso: guarde como segredo.
Webhook / polling / gateway
Webhook é um aviso que um serviço envia a um endereço quando algo acontece. Polling é perguntar de tempos em tempos se há novidades. Gateway é o programa que liga o canal de mensagem ao agente.
Systemd / serviço / linger / root
Systemd gerencia processos no Linux. Serviço é um programa mantido em execução; linger mantém serviços do usuário após o logout. Root é o administrador com controle amplo da máquina.
Git / clone / wrapper / venv / uv / dnf
Git guarda versões do código; clone baixa uma cópia. Wrapper é um pequeno programa que chama outro. Venv isola bibliotecas Python; uv instala e gerencia esse ambiente; dnf instala pacotes no Oracle Linux.
YAML / .env / chmod 600 / STT / av
YAML é um formato de configuração; .env guarda variáveis como tokens. chmod 600 restringe leitura e escrita ao dono. STT transforma fala em texto; av é uma biblioteca para ler áudio e vídeo.
MCP / Composio / escopo
MCP padroniza a ligação do agente a ferramentas. Composio centraliza integrações e autenticação de apps. Escopo é a lista de ações autorizadas em uma conexão.
SDR / copy / redact / quota / capacity
SDR trabalha a prospecção comercial; copy é texto para comunicação e venda. Redact é ocultar dados sensíveis. Quota é o limite da sua conta; capacity é hardware de fato disponível.
FAÇA O SEU

Como fazer o seu

Comece pelo pacote Naima e entregue o LEIA-ME-CLAUDE.md ao seu agente de código. Use este tutorial como mapa da demo.

  1. Clone o naima-completo. git clone https://github.com/jazzautomations/naima-completo.git
  2. Dê o pacote ao agente. Peça para ler naima-hermes/LEIA-ME-CLAUDE.md e conduzir a instalação na sua VPS, seguindo os capítulos acima.
  3. Crie seu bot no Telegram. Use @BotFather, configure o token e restrinja o acesso ao seu ID numérico.
  4. Faça o OAuth. O agente inicia o fluxo; você autoriza sua conta no próprio navegador.
  5. Coloque no ar. Viva. Ative o gateway, teste uma mensagem, confirme o SSH privado e feche a porta 22 pública. Pode fechar o laptop.
github.com/jazzautomations/ naima-completo
Referências técnicas consultadas

A história, os resultados de capacidade e os nomes de modelo seguem os fatos fornecidos para esta demo. Sintaxe e contexto: OCI CLI · route-table update , Tailscale · portas de firewall e os repositórios listados acima. Atualizações futuras dos projetos podem exigir ajustes.

▶ ABRIR APRESENTAÇÃO (slides) LEVE O MANUAL PARA O PROJETOR / 25 SLIDES