Pular para o conteúdo
ai-memory
EnglishPortuguês (Brasil)Españolעברית日本語한국어
Menu

Produto

Soluções

Integrações

Desenvolvedores

Idioma

ComeçarGitHub

Desenvolvedores

Instalação rápida

Instale, configure e inicie seu agente. Escolha a instalação local para uma máquina ou siga os passos de servidor compartilhado para uma equipe.

Só euMeu timeConfira se está funcionando

Só eu

Instale um binário, deixe que ele suba um servidor local e abra seu agente. O servidor escuta em 127.0.0.1:49374, então nada de fora desta máquina consegue acessá-lo. Uma instalação nova guarda o token num arquivo só do dono, que os hooks e a CLI leem, então você não digita nenhum.

  1. Instale o binário

    O script baixa a release para o seu SO e processador, confere com o arquivo .sha256 publicado e se recusa a instalar se não bater. Ele linka ~/.local/bin/ai-memory e não precisa de root.

    Terminal
    curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

  2. Configure

    setup cria o diretório de dados e o token, inicia um serviço do usuário e conecta os agentes selecionados. Use setup --plan para conferir sem alterar nada, ou setup --web para escolher os agentes numa página local do navegador.

    Terminal
    ai-memory setup

  3. Abra seu agente por ele

    Reinicie seus agentes uma vez. Abrir o claude direto continua funcionando depois.

    Terminal
    ai-memory run claude

Instalar

Subir o servidor

127.0.0.1:49374

Rodar seu agente

hooks / MCP

O caminho solo inteiro. O servidor fica em loopback, e seu agente chega nele de dois jeitos: os hooks capturam a sessão, o MCP deixa o agente buscar nela.

ai-memory run é a forma de abrir um agente. Ele configura o harness na primeira abertura, escolhe o escopo de projeto certo e adiciona retomada de sessão entre harnesses. Um agente aberto direto ainda captura pelos hooks dele, mas você não esquece nada passando pelo launcher. Leia como funciona a abertura gerenciada.

Confira se está funcionando

Três checagens, da rede até o agente.

O servidor responde

Em uma instalação nova com autenticação, esta requisição sem credenciais deve retornar HTTP 401 com “auth required”. Isso prova apenas que o servidor está acessível. A próxima verificação testa o acesso autenticado da CLI.

Terminal
curl -i http://127.0.0.1:49374/mcp

A CLI chega nele

A CLI é um cliente HTTP fino. Se este comando imprimir um status, os hooks também conseguem chegar no servidor.

Terminal
ai-memory status

O agente lembra

Em um projeto sem dados sensíveis, peça ao primeiro agente para salvar uma decisão específica do projeto. Encerre a sessão, abra outro agente compatível no mesmo diretório e peça essa decisão e a página salva que a registra.

“Qual decisão do projeto eu salvei e em qual página de memória ela está registrada?”

Depois do primeiro agente

Os três são opcionais. Faça quando precisar.

Adicione outro agente

Abra o agente uma vez pelo ai-memory e ele já fica configurado. Os dois agentes passam a compartilhar uma única memória de projeto.

Terminal
ai-memory run codex

Veja todos os agentes suportados e o nome de cada um

Opcional: resumos melhores com um LLM

Captura, busca e resumos por regras funcionam sem provedor. Adicionar um habilita resumos mais ricos e autoaperfeiçoamento agendado, que aplica edições validadas automaticamente por padrão. Em servidores compartilhados, defina [auto_improve] require_approval = true. Configure as variáveis abaixo no ambiente do servidor e reinicie.

ambiente do servidor
AI_MEMORY_LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

Compare os provedores, incluindo assinaturas e modelos locais

Desfazer tudo

Isto remove só o que o ai-memory instalou. Os comandos de instalação são idempotentes, e cada um grava um backup com timestamp ao lado de qualquer arquivo em que mexe.

Terminal
ai-memory uninstall --apply

Meu time

Um servidor que todas as máquinas e todos os colegas de time acessam. Não existe replicação entre servidores: memória compartilhada quer dizer que todo mundo se conecta no mesmo.

alice

bob

carol

Um servidor compartilhado

Token

Uma wiki para o time

Uma chave de API cada

O servidor guarda a wiki. Pessoas recebem contas, máquinas recebem chaves de API, e o token de root fica com quem roda o servidor.

  1. Inicie o servidor atrás de um proxy local

    Instale primeiro a CLI nativa no host do servidor. Estes comandos publicam o Docker só em loopback e definem as credenciais de root para a CLI neste shell. Troque memory.example.com pelo seu domínio. Mantenha o token root privado; os laptops receberão chaves individuais depois.

    no servidor
    ROOT_TOKEN=$(ai-memory generate-auth-token)
export AI_MEMORY_SERVER_URL="http://127.0.0.1:49374"
export AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN"
docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    -e AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN" \
    -e AI_MEMORY_AUTH__SECURE_COOKIE=true \
    -e AI_MEMORY_ALLOWED_HOSTS="memory.example.com,localhost,127.0.0.1" \
    akitaonrails/ai-memory:latest

  2. Configure e verifique o TLS antes de conectar clientes

    Coloque um proxy reverso no mesmo host, encaminhando HTTPS do seu domínio para 127.0.0.1:49374. Siga a configuração de TLS e verifique o certificado em um laptop antes de enviar chaves. Um token bearer autentica; ele não criptografa o tráfego.

  3. Crie as pessoas

    Use o shell do servidor onde as variáveis de root continuam exportadas. A senha temporária aparece uma vez e deve ser trocada no primeiro login. Este comando não emite uma chave de API. O guia de usuários cobre a identidade root e o login pelo navegador.

    Terminal
    ai-memory user add-human --username alice --email alice@home --name "Alice Smith"

  4. Dê uma chave de API para cada pessoa

    O segredo aim_ é mostrado uma única vez. ai-memory api-key rotate <id> e ai-memory api-key revoke <id> têm efeito imediato.

    Terminal
    ai-memory api-key add --username alice --label codex-laptop

  5. Aponte cada máquina para o servidor

    Instale a CLI em cada laptop. Troque o domínio e a chave abaixo pelo seu endpoint HTTPS e pela chave emitida para essa pessoa. Em Unix, o instalador de hooks guarda o token em um arquivo acessível só ao dono; os comandos gerados não o contêm. --as-user rotula a instalação e não concede permissões.

    em cada laptop
    # Troque o exemplo pela chave aim_ emitida para esta pessoa; nunca use ROOT_TOKEN
USER_API_KEY='aim_REPLACE_WITH_ISSUED_KEY'
export AI_MEMORY_SERVER_URL="https://memory.example.com"
export AI_MEMORY_AUTH_TOKEN="$USER_API_KEY"

ai-memory install-mcp   --client claude-code --apply
ai-memory install-hooks --apply --agent claude-code \
    --as-user alice --auth-token "$USER_API_KEY"

# depois abra como sempre
ai-memory run claude

Continue lendo

Travou em algum passo?

O cookbook de instalação no GitHub tem os comandos por agente, servidores remotos e Windows. O issue tracker está aberto.

Instalar agoraDê uma estrela no GitHub