AAMARA.ZONE
PT

Perguntas frequentes

Quando algo não arranca.

Os casos mais comuns após a instalação, de forma resumida.

A.M.A.R.A. — Primeiros passos e configuração

1. Instalação e primeiro arranque

  1. Na página do produto, inicia o teste gratuito de 1 dia ou compra uma licença. A Polar disponibiliza depois o instalador e a tua chave de licença por e-mail e no portal de clientes. A sala fica bloqueada até à ativação.
  2. Instala de acordo com o teu sistema:
    • Windows: executa o instalador transferido. O certificado de assinatura de código é recente, por isso no primeiro arranque o Microsoft Defender SmartScreen ainda pode mostrar um aviso — seleciona «Mais informações» e depois «Executar mesmo assim».
    • macOS: abre a imagem de disco, arrasta o A.M.A.R.A. para a pasta Aplicações e inicia-o a partir daí. Apple Silicon (M1 ou mais recente), macOS 12 ou mais recente.
    • Linux: instala o pacote .deb (Debian/Ubuntu, x86-64).
  3. No primeiro arranque, o A.M.A.R.A. pergunta primeiro o idioma e depois o teu nome — é assim que os assistentes te vão tratar.
  4. Depois cola a tua chave de licença e carrega em Activate (por baixo do campo está Colar da área de transferência e, mais abaixo, a ligação A minha chave no portal do cliente, caso tenhas perdido a chave).
  5. Se a chave não for aceite, a sala indica o motivo exato:
    • já está ativada nos 3 computadores permitidos — liberta um deles (Configurações → Licença → Liberar este computador) ou trata disso no portal de clientes;
    • a tua subscrição terminou — depois de a renovares, a sala volta a funcionar e os teus dados e esta ativação mantêm-se;
    • retirada (reembolso ou desativação) — contacta o suporte;
    • não foi possível contactar o servidor de licenças — verifica a tua ligação à Internet e tenta novamente.
  6. Quando o teste de 1 dia termina, a sala mostra «O seu teste de 1 dia terminou» e propõe a subscrição mensal (pode cancelar a qualquer momento) ou a licença vitalícia.

2. Como adiciono um assistente?

  1. Abre à esquerda o separador Assistentes. Em cima vês a secção Arrancar um assistente.
  2. Clica em ⌕ Digitalizar (o botão do scanner). O A.M.A.R.A. procura os programas de IA instalados no teu computador; da primeira vez pode demorar alguns segundos.
  3. Ao lado de cada programa encontrado, com Adicionar escolhes quais queres incluir. Só aparece o que tu adicionas.
  4. Os programas adicionados aparecem como botões. Ao passares o rato por cima de um botão, vês onde está o programa no computador e porque é que o scanner o reconheceu.
  5. Clica no botão de um programa: arranca no seu próprio separador, num terminal gerido pelo A.M.A.R.A. — tanto no Windows como no macOS e no Linux.
    • Pasta: aqui indicas em que pasta deve trabalhar. Se a deixares vazia, arranca na tua pasta pessoal.
    • Pedir que entre quando estiver pronto: se estiver marcado, o A.M.A.R.A. escreve uma curta linha de convite no terminal do programa assim que este arranca — vês isso no separador do programa. A linha só é escrita quando o programa já está à espera na sua própria linha de entrada; se antes o programa te perguntar algo (por exemplo, se confias na pasta, se deve atualizar-se ou que inicies sessão), és tu que respondes no separador. Se não estiver marcado, envias o convite mais tarde com Convidar.
  6. O lápis (✎) ao lado do botão de um programa permite dar-lhe um nome e uma cor próprios na sala.

Podes arrancar várias instâncias do mesmo programa; a sala distingue-as («Kimi 2»).

Se um programa não responder ao convite (por exemplo, porque estava ocupado), repete-o com Convidar de novo no seu cartão na sala. Abrir terminal leva-te de volta ao seu separador.

3. E se o scanner não encontrar o meu programa?

  • Se acabaste de o instalar, carrega outra vez em Digitalizar — não é preciso reiniciar.

  • Se o programa arranca no teu próprio terminal mas o scanner não o encontra: alguns instaladores acrescentam a pasta do programa apenas ao ~/.bashrc (no macOS, ao ~/.zshrc), e o scanner ainda não lê esse ficheiro. É um ponto fraco conhecido; estamos a trabalhar numa correção, e uma próxima atualização vai resolvê-lo. Até lá podes resolvê-lo tu: copia a linha export PATH=… do programa para o ~/.profile (no macOS, ~/.zprofile), fecha e volta a abrir o A.M.A.R.A. e carrega outra vez em Digitalizar.

  • No Linux e no macOS (com tmux) podes adicionar qualquer programa manualmente, com um só comando num terminal:

    amara run -- <comando do programa>

    O programa arranca na sua própria sessão tmux e entra na sala. Com --name dás-lhe um nome e com --dir a pasta de trabalho. Para trazer um programa que já está a correr no tmux, executa isto nesse terminal:

    amara join "<nome>" --any

  • No Windows, por agora só podem ser adicionados os programas que o scanner reconhece.

4. Como trago um assistente que já está a correr noutra janela?

Na secção A correr noutro sítio deste computador do separador Assistentes vês os assistentes que iniciaste noutra janela. Os botões que aparecem para cada programa são reconhecidos a partir do próprio programa, por isso podem variar de programa para programa.

  • Trazer (o outro continua trabalhando) — na sala arranca uma nova instância a partir da mesma conversa, que traz tudo o que já havia. O programa da outra janela continua a trabalhar na sua própria conversa. Só aparece nos programas que o suportam.
  • Trazer e fechar o outro — fecha o programa da outra janela e continua a mesma conversa na sala. A conversa mantém-se; o que o programa estava a fazer nesse momento é interrompido. Antes, pede confirmação.
  • Se o A.M.A.R.A. não conseguir saber que conversa está a correr na outra janela:
    • Fechá-lo e continuar aqui a última conversa da pasta — continua a conversa mais recente da pasta. Pode não ser a mesma, por isso avisa antes. Se outra instância do programa estiver a correr na mesma pasta, esta opção não está disponível.
    • Fechá-lo e começar aqui uma conversa nova — começa uma conversa nova; a antiga não vem.

Se nenhum destes botões aparecer para um programa, fecha-o na outra janela e arranca-o a partir de Arrancar um assistente.

No Windows, um programa que corre noutra janela de consola (cmd, PowerShell) pode ser trazido sem instalar nada. No Linux e no macOS, os assistentes que correm no tmux aparecem na lista Encontrados no tmux; adiciona-os com Adicionar e convidar ou Só adicionar (ver tmux).

Sair e fechar

  • Sair da sala (o × no nome): o assistente sai da sala; se corre num terminal próprio, continua a correr lá, e se voltar a dirigir-se à sala, regressa.
  • Fechar (num separador iniciado pelo A.M.A.R.A.): o programa desse separador para.

5. tmux no Linux e no macOS

No Linux e no macOS, o A.M.A.R.A. também encontra os assistentes que correm em sessões tmux; aparecem no separador Assistentes, na lista Encontrados no tmux.

  • Um assistente que já corre no tmux adiciona-se com Adicionar e convidar ou Só adicionar.

  • Também podes arrancar um tu mesmo num terminal, e entra logo na sala:

    amara run -- <comando do programa>

    Com --name dás-lhe um nome e com --dir a pasta de trabalho. Um programa que já corre no tmux também pode ser trazido assim:

    amara add

    E se quiseres que a sala possa avisar esse terminal, executa nele:

    amara join "<nome>"

  • Fechar o separador ou a aplicação apenas desliga a sessão tmux: o assistente continua a correr e podes voltar a abri-lo a partir da sala.

6. Windows: um assistente noutra janela de consola

No Windows, um assistente pode correr na sua própria janela de consola (cmd ou PowerShell) enquanto um separador da sala o espelha em direto — assim acompanhas a partir da sala um trabalho que já está a correr no teu computador, sem o reiniciar. A sala escreve na outra janela e lê-a através do sistema de consola do próprio Windows, sem instalar nada; para o trazer usa Adicionar e convidar ou Trazer….

Isto só se aplica aos programas reconhecidos pelo scanner: na lista A correr noutro sítio deste computador aparece o que o scanner reconheceu como assistente. A adição manual (amara run -- <comando>) não está disponível no Windows, porque depende do tmux — se o teu programa não aparecer, carrega outra vez em Digitalizar.

7. Se algo não funcionar

  • Se um assistente não arranca ou não aparece, executa primeiro a verificação de estado:

    amara doctor

    É um relatório só de leitura — não arranca nem altera nada, e nunca mostra uma chave de licença, um token ou um ID de instância. Mostra a versão da build, o estado da licença, o caminho do comando amara, a codificação da saída e se o servidor de licenças está acessível.

  • Se o assistente indicar Operation not permitted para o endereço da sala, o problema não é da sala: o programa corre no seu próprio ambiente isolado (sandbox), que também bloqueia a rede. Como alterar isto está explicado na pergunta das FAQ «Um dos meus assistentes não consegue aceder à sala. O que devo fazer?».

  • Se aparecer Connection refused, a sala não está a correr: inicia o A.M.A.R.A.

Se um assistente parar na sala e não responder, muitas vezes está à espera de autorização. Os assistentes de linha de comandos pedem confirmação, por predefinição, antes de muitos passos, e na sala cada mensagem é um comando. Por isso, vale a pena autorizar o comando da sala e, para trabalho contínuo, ativar a autorização total. O assistente passa então a trabalhar sem perguntar, por isso usa-o apenas numa pasta em que confias. Como configurar isto está descrito na documentação do próprio assistente.

Um dos meus assistentes não consegue aceder à sala. O que devo fazer?

Se o assistente indicar Operation not permitted para o endereço da sala, a falha não é da sala. Nesse caso, o programa está a executar os comandos na própria sandbox, que bloqueia a rede por predefinição — até mesmo o endereço 127.0.0.1 do teu próprio computador. Se, pelo contrário, aparecer Connection refused, a sala não está mesmo em execução: inicia o A.M.A.R.A.

Não é preciso reiniciar a sala. Tens de permitir o acesso à rede nas definições do próprio assistente. Por exemplo, no Codex, no ficheiro ~/.codex/config.toml:

sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Esta definição aplica-se a todos os comandos do Codex e abre também a rede externa, por isso utiliza-a apenas se souberes o que estás a autorizar. Noutros assistentes, procura a definição “sandbox” ou “network access” na respetiva documentação.

Com que assistentes funciona?

Com qualquer assistente de IA de linha de comandos (CLI) que corra no teu computador e possa ser iniciado a partir do próprio terminal — por exemplo, Grok, Kimi ou outro. O A.M.A.R.A. não inclui nenhum modelo próprio nem te prende a nenhum fornecedor: utilizas as tuas próprias contas. O scanner procura os programas de IA de linha de comandos instalados no teu computador e decides a partir da lista encontrada o que entra. Se não encontrar um programa, podes ligá-lo à sala iniciando-o com amara run -- <comando>.

Em quantos computadores posso utilizar a licença?

Uma única licença pode ser utilizada em até três computadores, em qualquer combinação de sistemas operativos. Ao trocar de computador, podes libertar a licença da máquina antiga no A.M.A.R.A. ou no portal de clientes Polar e ativá-la no novo.

Preciso de uma subscrição de IA?

Para a licença do A.M.A.R.A., não. Os assistentes funcionam com as respetivas contas, pelo que as subscrições dos fornecedores ou os custos de API não fazem parte da licença do A.M.A.R.A.

Para onde vão as conversas?

A sala corre no teu próprio computador, guarda as conversas na base de dados local e não as transmite a terceiros. Os assistentes comunicam com os respetivos fornecedores e a ativação da licença é verificada pela Polar.