Como funciona

Da palavra de chamada à tarefa feita

Três camadas, duas delas invisíveis. Descrevemo-las porque vale a pena saber o que acontece ao que diz.

Instalação e primeira utilização

  1. Transferir e instalar

    Um ficheiro: uma imagem de disco. Mova a Ariadne para a pasta Aplicações e abra-a A PARTIR DALI, não da janela da imagem. Isto não é formalidade: uma aplicação aberta diretamente da imagem não se consegue atualizar, e isso parece exatamente igual a não haver versões novas. As instruções lá dentro são lidas pelo VoiceOver do princípio ao fim.

  2. Ligar uma chave e uma camada de raciocínio

    A Ariadne não tem modelo próprio; funciona com as suas contas. São precisas duas coisas:

    • Uma chave OpenAI: obrigatória.Cola-se uma vez, em Definições → Voz. Sem ela, a conversa por voz não arranca.
    • Claude Code ou Codex: para executar tarefas.Basta um dos dois. Instala-se no terminal.
    • A conta: o Claude aceita dois caminhos, o Codex um.O Claude aceita a sessão iniciada com claude, ou uma chave em ANTHROPIC_API_KEY. O Codex aceita apenas a sessão iniciada com codex login.
  3. Dar as permissões

    No primeiro arranque: microfone, acessibilidade, contactos e calendário. Ler o correio exige ainda acesso total ao disco, e baixar o som de fundo exige gravação de ecrã. A Ariadne pede-as em voz alta e diz para que serve cada uma, em vez de o mandar às definições sem explicação.

  4. Chamar, ou carregar no atalho

    «Olá Ariadne» ou Command Control Option Espaço, a partir de qualquer aplicação.

O que a Ariadne precisa

A Ariadne não tem modelo próprio e não trata de pagamentos: funciona com as suas contas, e a fatura vai direta ao fornecedor. É por isso que a aplicação é gratuita. Antes da primeira utilização, precisa de duas coisas.

Uma chave OpenAI: obrigatória

É ela que sustenta a conversa por voz e a descrição de imagens. Sem ela a Ariadne não começa uma conversa: diz o que falta. Cola-a uma vez; depois fica guardada no porta-chaves do macOS.

Claude Code ou Codex: para as tarefas

A camada que chega ao correio, aos ficheiros, à shell e a máquinas remotas. Basta um dos dois. Sem ela a Ariadne continua a falar e a descrever o ecrã, mas não executa a tarefa.

Como ligar isto

A chave OpenAI

Crie-a na sua conta OpenAI, copie-a e cole-a na Ariadne.

  • platform.openai.com

Definições → Voz. É o único sítio onde é precisa.

Claude Code ou Codex

Basta um dos dois. Instala-se no terminal e inicia-se sessão.

Claude Code

  • brew install --cask claude-code
  • claude

ou

Codex

  • codex login

O Codex vem também com a aplicação ChatGPT.

A verificação

A Ariadne verifica os dois ao arrancar e diz o que falta, com o comando que resolve.

Ter o claude ou o codex instalado não chega por si só: é preciso uma conta ativa.

O que acontece quando fala

Quem ouve a palavra de chamada é o reconhecimento de voz integrado no macOS. Até ela ser dita, nenhum áudio sai do computador: nada é enviado e nada é guardado.

Depois da palavra de chamada, a conversa passa para o modelo de voz que fala e ouve. Quando pede algo que uma conversa não resolve, ele entrega o trabalho à camada de execução e avisa-o de que está a trabalhar.

A camada de execução tem acesso aos ficheiros, à shell, ao correio, à casa e às extensões. Faz o trabalho e devolve o resultado, que o modelo de voz transmite numa frase simples.

Decisões tomadas para quem ouve, não para quem olha

Algumas escolhas que só se notam quando não se está a olhar para o ecrã.

  • O Esc interrompe a fala e a tarefa em curso: sempre, a partir de qualquer aplicação.
  • Se uma tarefa demorar mais do que um instante, a Ariadne di-lo numa frase e depois cala-se. Não fica a relatar que ainda não aconteceu nada.
  • Enquanto uma ferramenta trabalha, o microfone fica fechado, para o assistente não responder ao que diz para si próprio.
  • Atualiza-se sozinha e sem ruído, e adia a instalação até ao fim da conversa.

Perguntas frequentes

A Ariadne substitui o VoiceOver?

Não. O VoiceOver lê o ecrã e a Ariadne não o faz. A Ariadne executa pedidos. Funcionam em conjunto.

Tenho de decorar comandos?

Não. Fala por frases normais, como falaria a uma pessoa. Se algo não ficar claro, ela pergunta.

E se ela se enganar?

Antes de tudo o que é irreversível, pergunta primeiro. Durante a tarefa, o Esc interrompe. No fim, diz o que fez.

Preciso mesmo de uma chave OpenAI?

Sim. É ela que sustenta a conversa por voz e a descrição de imagens, por isso sem ela a Ariadne não começa uma conversa e diz-lhe o que falta. A chave cria-se na sua própria conta OpenAI e cola-se uma vez nas Definições; paga diretamente ao fornecedor aquilo que realmente usar.

Porquê Claude Code ou Codex?

É a camada que executa os pedidos que vão além da conversa: correio, ficheiros, shell, máquinas remotas. Basta um dos dois, instalado e com conta ativa. Sem ela a Ariadne continua a falar e a descrever o ecrã, mas não executa a tarefa, e di-lo com clareza.

Tudo isto tem custos à parte?

A Ariadne em si é gratuita e não trata de pagamentos. Acerta contas diretamente com os fornecedores onde tem conta: a OpenAI pela chave, e a camada de raciocínio ao abrigo da sua própria subscrição Claude ou ChatGPT.

Veja na prática

Transfira e experimente no seu computador.

Requer um Mac com chip da Apple (M1 ou posterior) e macOS 26 ou posterior. A aplicação atualiza-se sozinha, em silêncio, e deixa a instalação para o fim da conversa, para que nada o interrompa a meio de uma frase.