J_ JAZZ AUTOMATIONS NAIMA / ORACLE + TAILSCALE [MANUAL / ÍNDICE]
01 / DEMO DE PALESTRA / JAZZ AUTOMATIONS

Naima numa
VPS Oracle.

Tailscale na porta.
Telegram na mão. Agente viva 24h.

ORACLE LINUX HERMES TAILSCALE

MANUAL DE CAMPO Nº 001
INFRAESTRUTURA / IDENTIDADE / AUTONOMIA

02 / O PROBLEMA

Você fecha a tampa.
O agente para.

Laptop

Dormiu, desconectou,
acabou o processo.

VPS

Uma casa ligada 24h.
Você acessa pelo Telegram.

03 / A BRISA DOS SERVIDORES

Um computador
que não dorme.

[O QUE É] Datacenter, rede redundante e uma máquina ligada 24/7. Nesta demo, com IP público.

[POR QUE] A agente mora no servidor; você conversa pelo celular.

[PEGADINHA] VPS = máquina virtual. Cloud = serviços sob demanda. Dedicado = hardware só seu. Todos exigem manutenção.

04 / ARQUITETURA ALVO

Uma conversa.
Um servidor por trás.

Dono → Telegram → Gateway / VPS
Hermes → openai-codex OAuth → ChatGPT

Administração por SSH na tailnet 100.x.

O agente desenha a arquitetura durante o provisionamento.
[FRAME] assets/frames/p1-120.jpg O agente desenha a arquitetura durante o provisionamento. Ampliar frame
05 / CLI DE AGENTES

Você dá intenção.
O agente executa.

Humano → Agente CLI → Máquina real

[O QUE É] Devin CLI, Codex CLI e jazz-cli dirigem o terminal e as ferramentas.

[POR QUE] No vídeo, o Devin CLI constrói a infraestrutura e instala a Naima.

[PEGADINHA] Credenciais e permissões definem o alcance; comandos podem gerar custo.

06 / OCI AGENT SKILLS

O manual da cloud.
Dentro do agente.

[O QUE É] ~30 skills no recorte da palestra: compute, network, quotas, custo e capacity.

[POR QUE] Dê o link do GitHub ao agente e peça para instalar; SKILL.md ensina o restante.

[PEGADINHA] Skills não dão credenciais OCI nem garantem capacidade física.

github.com/jazzautomations/oci-agent-skills
Devin CLI lista as skills OCI instaladas.
[FRAME] assets/frames/p1-15.jpg Devin CLI lista as skills OCI instaladas. Ampliar frame
07 / ORACLE: GOTCHAS REAIS

Crédito não significa
qualquer máquina.

E5.Flex · AMD

Pago com créditos trial.

Teto observado: ~6 OCPU / 96 GB por instância.

A1.Flex · ARM

Grátis, mas em Chicago:

OUT_OF_HOST_CAPACITY

Relato da demo em us-chicago-1. Imagem: Oracle Linux 9.8.

08 / A REDE

A rede tem saída.
O site tem Funnel.

VCN 10.0.0.0/16
Subnet pública 10.0.0.0/24
Rota padrão 0.0.0.0/0 → IGW

Serve → serviço só na tailnet.

Funnel → este site na internet, sem abrir TCP/80 ou TCP/443 na VPS.

Funnel publica o serviço escolhido. A demo usa proxy Vercel à frente; o SSH segue privado.

09 / TAILSCALE

O SSH entra
pela tailnet.

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
ssh opc@100.83.142.44

Instale também no seu computador. Autorize o nó no admin console.
100.83.142.44 é o IP da demo; use o IP da sua VPS.

SSH comum sobre Tailscale usa a chave da VPS. Tailscale SSH é opcional: identidade + política SSH, habilitadas à parte.

Login do Tailscale concluído no navegador.
[FRAME] assets/frames/p1-300.jpg Login do Tailscale concluído no navegador. Ampliar frame
10 / TAILNET EM PROFUNDIDADE

Uma mesh privada.
Seus dispositivos.

[O QUE É] WireGuard + IP 100.x estável por nó + nomes via MagicDNS.

[POR QUE] P2P conecta direto; DERP retransmite tráfego criptografado quando necessário.

[PEGADINHA] ACL/tags limitam quem acessa o quê; pertencer à tailnet não basta.

11 / SSH / PORTA 22

A caixa de correio
do terminal remoto.

[O QUE É] SSH = shell criptografado. Porta = caixa numerada do IP; SSH usa TCP/22.

[POR QUE] Chave pública no servidor, privada com você. Porta pública atrai varreduras e brute force.

[PEGADINHA] Primeiro teste o SSH na tailnet. Depois feche a 22 pública: dark host para administração.

INTERNET :22 → DROP
TAILNET :22 → OK
12 / LOCKDOWN

Fechar pra rua.
Manter pra você.

Antes

TCP/22 público

UDP/41641 + ICMP

Depois

TCP/22 público

Só UDP/41641 + ICMP

Teste SSH pela tailnet antes de remover TCP/22. Egress e IP público continuam.

13 / A PROVA

O que vale é
a nova conexão.

ssh -o ConnectTimeout=8 opc@IP_PUBLICO
# Connection timed out

ssh opc@100.83.142.44
# Entrou pela tailnet.

Confira também NSGs e outras security lists: regras de entrada se somam.

Prova e arquitetura: SSH público DROP, tailnet OK.
[FRAME] assets/frames/p1-430.jpg Prova e arquitetura: SSH público DROP, tailnet OK. Ampliar frame
14 / HARNESS / O CONCEITO CENTRAL

O LLM fala.
O harness faz agir.

HERMES / HARNESS DA NAIMA
terminal + arquivos + browser memória + skills permissões + SOUL.md + AGENTS.md

[O QUE É] Tools + loop + permissões + regras + memória + skills.

[POR QUE] Hermes é o harness da Naima. SOUL é personalidade; skills são conhecimento carregável.

[PEGADINHA] SOUL.md / AGENTS.md orientam; permissões do runtime precisam limitar de verdade.

15 / HERMES AGENT

O runtime é
open source.

NousResearch/hermes-agent

/usr/local/lib/hermes-agent  # clone + setup-hermes.sh (uv)
/usr/local/bin/hermes        # wrapper
HERMES_HOME=/root/.hermes

Nesta demo: roda como root. Oracle Linux usa dnf.

O agente instala o runtime Hermes.
[FRAME] assets/frames/p2-60.jpg O agente instala o runtime Hermes. Ampliar frame
16 / O PACOTE NAIMA

Identidade, regras
e nove skills.

O agente lê

naima-hermes/
LEIA-ME-CLAUDE.md

E instala o pacote.

Em /root/.hermes/

config.yaml · .env
SOUL.md · AGENTS.md
skills/jazz/ · 9 SKILL.md

TELEGRAM_BOT_TOKEN + TELEGRAM_ALLOWED_USERS no .env · chmod 600.

O agente segue o LEIA-ME da Naima.
[FRAME] assets/frames/p2-180.jpg O agente segue o LEIA-ME da Naima. Ampliar frame
17 / OAUTH CHATGPT

Seu login.
Sem API key.

hermes auth add openai-codex

Link + código → dono autoriza
com ChatGPT Plus / Pro.

auth.openai.com/codex/device · credenciais em auth.json.
Sem custo de API neste fluxo; assinatura e limites continuam.

OAuth: o dono autoriza o acesso sem entregar a senha ao agente.

18 / O CÉREBRO

O modelo mora
na tua assinatura.

CONFIG.YAML

gpt-5.6-luna

provider: openai-codex

O QUE SIGNIFICA

O Hermes fala com o Codex pela conta ChatGPT Plus/Pro do dono. Sem API key, sem billing por token.

Outros providers também funcionam — a config troca o cérebro sem trocar a agente.

19 / TELEGRAM VIVO

A sessão fecha.
A agente fica.

loginctl enable-linger root
systemctl --user enable --now hermes-gateway.service
# active

Dono manda mensagem. Naima responde.

Serviço em /root/.config/systemd/user/ · polling, sem porta de webhook.

Teste de fogo registrado na demo: 100/100.
[FRAME] assets/frames/p2-340.jpg Teste de fogo registrado na demo: 100/100. Ampliar frame
20 / VOZ TAMBÉM

Áudio entra.
Texto sai localmente.

faster-whisper

Instalado com uv pip
no venv do Hermes.

stt.enabled: true
provider: local · model: base

Pegadinha

av ≥ 15 × metadata_errors

Patch em audio.py
ou versão av<15 compatível.

21 / TIME + MÉTODOS

Nove skills.
Um time dentro dela.

Juliana operação / design

Clone do dono SDR

Paulo desenvolvimento

Jonathan copy

Carrossel Instagram · landing pages · propostas comerciais
Vídeo sanduíche · conectar Instagram / Zernio

22 / COMPOSIO / TOOLS ALÉM DO TERMINAL

O HARNESS DÁ MÃOS
NA MÁQUINA.
O COMPOSIO, NA INTERNET.

NAIMA ──> COMPOSIO ──┬── Gmail / Calendar
                    └── Notion / Sheets
          uma API + autenticação integrada

API: um programa pede ações a outro.
OAuth: o dono autoriza cada conta e suas permissões.

~300 apps na referência do briefing; catálogo atual: 1.700+.
Alternativa: MCP servers, programas que oferecem ferramentas ao agente.
Extensão possível da demo. composio.dev / ler o capítulo

23 / SEGURANÇA EM CAMADAS

Autonomia exige
limites claros.

TAILNET Transporte WireGuard + identidade + ACL/tags.

BORDA OCI Security list sem TCP/22 público; revisar NSGs.

SOUL / AGENTS Regras da agente + permissões reais nas ferramentas.

COFRE Acesso mínimo aos segredos; demo usa arquivos modo 600.

REDACT Mascarar segredos em logs, capturas e respostas.

Nenhuma camada sozinha basta. Regras de texto não são isolamento; nesta demo o runtime roda como root com approvals.mode off.

24 / CUSTOS + FAÇA O SEU

Como fazer o seu.
Do clone à conversa.

  1. Clone naima-completo .
  2. Dê o LEIA-ME-CLAUDE.md ao agente.
  3. Crie o bot Telegram e restrinja ao dono.
  4. Autorize sua conta pelo OAuth .
  5. Ative, teste, feche a 22 pública. Viva.
github.com/jazzautomations/naima-completo

Trial consome créditos; OAuth mantém assinatura e limites. Passo a passo e custos no tutorial.

25 / PRONTO PARA A DEMO

A Naima fica.
Você vai.

Telegram → gateway → Hermes → OAuth → ChatGPT.

Admin: tailnet 100.x · Rua: UDP/41641 + ICMP
Site público: Vercel proxy → Tailscale Funnel → VPS

github.com/jazzautomations/naima-completo

JAZZ AUTOMATIONS _

Telegram e arquitetura final na execução real.
[FRAME] assets/frames/p2-400.jpg Telegram e arquitetura final na execução real. Ampliar frame