Oficina · Nota técnica #01 · projeto pessoal

Darkover

Um assistente de voz holográfico que roda no navegador

Diga “Hey Darkover”: o rosto é um holograma em WebGL no navegador, e o cérebro roda no Claude Code em modo headless ou num Ollama na rede local. Ele busca na web, gera imagens, controla o celular e lê e-mail através das suas ferramentas.

2 min de leitura por Edinaldo Sá

  • Assistente de voz
  • Agentes
  • Three.js
  • GLSL
  • React
  • Ollama
Esquema ilustrativo: um rosto holográfico em wireframe com o texto “Hey Darkover” liga a uma caixa “bridge Node.js”, que se divide entre “Claude Code headless” e “Ollama LAN”; caixas tracejadas marcam ElevenLabs e DarkoverLearning como opcionais.
Esquema ilustrativo feito para este post. Não é uma captura de tela.

Rosto no navegador, cérebro fora dele

Diga “Hey Darkover” e ele acorda, escuta e age. O Darkover é um assistente de voz com interface holográfica que roda numa página web. O rosto vive no navegador; o cérebro roda em outro lugar.

Essa separação tem uma consequência prática: até um laptop modesto dá conta, porque a máquina do usuário só precisa desenhar a interface.

Arquitetura

  1. Navegador: wake word, microfone e a interface holográfica em React + Vite + Three.js, com shaders GLSL próprios.
  2. Bridge Node: uma ponte leve entre a página e o cérebro.
  3. Cérebro: o Claude Code em modo headless ou, como alternativa 100% local, o Ollama numa máquina da rede.
  4. Ações: o cérebro age através das suas ferramentas.

O que ele faz

Busca na web

Pesquisa e responde por voz.

Geração de imagem

Cria imagens a pedido.

Controle do celular

Age no celular através das suas ferramentas.

Leitura de e-mail

Lê o seu e-mail quando você pede.

Essas ações acontecem através das suas próprias ferramentas, e algumas mexem em coisas pessoais, como e-mail e celular.

Voz e memória

ElevenLabs, opcional

Com ele, a voz fica muito melhor e a transcrição, mais precisa. Sem ele, o Darkover usa a fala nativa do navegador e tudo continua funcionando.

Memória de longo prazo

Fica num serviço separado, o DarkoverLearning.

É o mesmo princípio do Coliseu IA: o add-on melhora a experiência, mas não é dependência.

Setup sem sustos

Assistente de voz tem pré-requisito chato. Por isso existe o npm run setup, que verifica tudo e explica em linguagem simples o que falta.

  • Node.js 20 ou mais novo
  • Claude Code instalado e logado (ou Ollama na rede)
  • Chrome ou Edge numa janela real
  • Opcional: ElevenLabs

O outro Darkover

Se o nome parece familiar, é porque Darkover também é o jogador-NPC autônomo do Ecos de Aether, que joga pelas mesmas regras que você. Lá, ele é um agente dentro de um RPG; aqui, é um assistente de voz. Os dois projetos dividem o nome e a ideia de um agente que age por conta própria.

Ficha técnica

  • React
  • Vite
  • Three.js + GLSL
  • Node (bridge)
  • Claude Code headless
  • Ollama
  • ElevenLabs (opcional)
Status
Produto funcional, com README detalhado e backlogs estruturados
Segurança
TLS configurado
Licença
Licença própria
Requisitos
Node.js 20+, Chrome ou Edge

Interessado em assistentes de voz, interfaces WebGL ou agentes com ferramentas? Vamos conversar.

Me escreva