Assistente pessoal de IA open source para planejamento, escrita e conhecimento pessoal, que roda no Mac ou pode ser hospedado por você com suas próprias chaves de modelo.
1752TypeScriptMITAtualizado há 3 dias
ShenSeanChen/waku-agent
Assistente pessoal de IA local-first, feito em Python legível, com loop de agente próprio, memória baseada em SQLite e evals integradas.
Alternativa open source a:ChatGPT
- Estrelas
- 2,082
- Forks
- 410
- Issues abertas
- 57
- Último commit
- há 11 dias
O que é?
waku-agent é um assistente pessoal de IA que roda na sua própria máquina. Ele é construído em torno de quatro partes: um harness que conecta gateways como terminal, dashboard no navegador, Telegram e Discord a um único loop de agente; um loop com cerca de 95 linhas de Python que raciocina, age e repete; um sistema de memória semântica, episódica e procedural (skills); e uma camada de evals que combina testes determinísticos com pontuação feita por LLM-as-judge.
A memória fica armazenada em um único arquivo SQLite, e um gate decide se vale a pena lembrar cada mensagem, enquanto uma etapa de consolidação decide o que manter. O projeto oferece suporte a vários provedores de modelos, incluindo Anthropic, OpenAI, Gemini, DeepSeek e OpenRouter, selecionados por meio de uma variável de ambiente e uma API key. Uma integração opcional conecta o agente ao serviço hospedado Waku Memory, permitindo compartilhar a mesma memória com outros agentes.
O código foi pensado para ser lido e modificado, não para ser usado como uma caixa-preta. O projeto usa a licença MIT, exceto pelo diretório hosted/, que usa a Elastic License 2.0.
Recursos principais
- 01Loop de agente com cerca de 95 linhas de Python puro, com raciocínio, ação e repetição
- 02Memória semântica, episódica e procedural armazenada em um arquivo SQLite local
- 03Gateways para terminal, dashboard no navegador, Telegram, Discord e voz
- 04Testes determinísticos e evals com LLM-as-judge, com gate de release
- 05Suporte a vários provedores de modelos, incluindo Anthropic, OpenAI, Gemini e OpenRouter
Casos de uso
- Rodar um assistente pessoal no laptop que mantém a memória localmente
- Estudar como loop de agente, recuperação de memória e evals se integram em uma base de código pequena
- Criar um fork do harness para adicionar um novo gateway de mensagens ou uma ferramenta
- Compartilhar uma memória entre Claude Code, Codex e outros agentes por meio do Waku Memory
Início rápido
- 1
Instale o pacote pelo PyPI
pip install waku-agent - 2
Converse com o Waku no terminal (na primeira vez, ele solicitará uma API key)
waku - 3
Ou abra o painel no navegador em localhost:7777
waku dashboard
Antes de usar
- É necessária uma API key de um provedor de modelos (por exemplo, Anthropic ou OpenAI) para executar.
Tópicos
Perguntas frequentes
- O que é waku-agent?
- Assistente pessoal de IA local-first, feito em Python legível, com loop de agente próprio, memória baseada em SQLite e evals integradas. waku-agent é um assistente pessoal de IA que roda na sua própria máquina. Ele é construído em torno de quatro partes: um harness que conecta gateways como terminal, dashboard no navegador, Telegram e Discord a um único loop de agente; um loop com cerca de 95 linhas de Python que raciocina, age e repete; um sistema de memória semântica, episódica e procedural (skills); e uma camada de evals que combina testes determinísticos com pontuação feita por LLM-as-judge.
- waku-agent é gratuito? Qual é a licença?
- waku-agent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- waku-agent ainda é mantido?
- Manutenção ativa. O último commit de waku-agent foi em 11 de out. de 2026.
- Para que posso usar waku-agent?
- Rodar um assistente pessoal no laptop que mantém a memória localmente Estudar como loop de agente, recuperação de memória e evals se integram em uma base de código pequena Criar um fork do harness para adicionar um novo gateway de mensagens ou uma ferramenta Compartilhar uma memória entre Claude Code, Codex e outros agentes por meio do Waku Memory
- Como instalar waku-agent?
- Instale o pacote pelo PyPI: pip install waku-agent Converse com o Waku no terminal (na primeira vez, ele solicitará uma API key): waku Ou abra o painel no navegador em localhost:7777: waku dashboard
- Onde consigo waku-agent?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ShenSeanChen/waku-agent
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um app leve e self-hosted de agente pessoal, com TUI e GUI, ferramentas para o workspace local, aprovação humana, sessões persistentes, memória e extensões de Skill/Plugin/MCP.
1844PythonMITAtualizado há 20 horas
Agente pessoal de IA local e auto-hospedado, com memória em camadas, permissões para ferramentas, workflows e integração com canais de mensagens instantâneas.
1375JavaMITAtualizado há 2 meses
Uma plataforma auto-hospedada de agentes de IA persistentes, com memória de longo prazo, que colaboram e respondem em canais de chat e rodam em um único container.
7116TypeScriptMITAtualizado ontem
Arquitetura documentada e plugin instalável do Claude Code para criar um chefe de gabinete de IA persistente, com memória, informes diários e tarefas agendadas em segundo plano.
8512HTMLMITAtualizado há 4 dias
Agente de OS pessoal local-first baseado no Hermes, que registra humor, sono, refeições e hábitos e revela padrões ao longo do tempo.
22016PythonMITAtualizado ontem