Asistente personal de IA de código abierto para planificar, escribir y gestionar conocimiento personal, ejecutable en Mac o autoalojado con tus propias claves de modelos.
1752TypeScriptMITActualizado hace 3 días
ShenSeanChen/waku-agent
Asistente personal de IA local-first, escrito en Python legible, con su propio bucle de agente, memoria basada en SQLite y evaluaciones integradas.
Alternativa open source a:ChatGPT
- Estrellas
- 2,082
- Forks
- 410
- Issues abiertos
- 57
- Último commit
- hace 11 días
¿Qué es?
waku-agent es un asistente personal de IA que se ejecuta en tu propia máquina. Se basa en cuatro componentes: un harness que conecta gateways como una terminal, un panel web, Telegram y Discord con un único bucle de agente; un bucle de unas 95 líneas de Python que razona, actúa y repite el proceso; un sistema de memoria semántica, episódica y procedimental (de habilidades); y una capa de evaluación que combina pruebas deterministas con puntuaciones de LLM-as-judge.
La memoria se almacena en un único archivo SQLite. Un filtro decide si vale la pena recordar cada mensaje, mientras que una fase de consolidación determina qué conservar. El proyecto es compatible con varios proveedores de modelos, como Anthropic, OpenAI, Gemini, DeepSeek y OpenRouter, que se seleccionan mediante una variable de entorno y una API key. Una integración opcional conecta el agente al servicio alojado Waku Memory para compartir la misma memoria con otros agentes.
El código está pensado para leerse y modificarse, no para usarse como una caja negra. Tiene licencia MIT, excepto el directorio hosted/, que utiliza Elastic License 2.0.
Funciones clave
- 01Bucle de agente de unas 95 líneas de Python sencillo, con razonamiento, acciones y repetición
- 02Memoria semántica, episódica y procedimental almacenada en un archivo SQLite local
- 03Gateways para terminal, panel web, Telegram, Discord y voz
- 04Pruebas deterministas y evaluaciones LLM-as-judge con un control para las versiones
- 05Compatibilidad con varios proveedores de modelos, como Anthropic, OpenAI, Gemini y OpenRouter
Casos de uso
- Ejecutar un asistente personal en tu laptop y guardar su memoria localmente
- Estudiar cómo se integran el bucle de agente, la recuperación de memoria y las evaluaciones en una base de código pequeña
- Crear un fork del harness para añadir un gateway de mensajería o una herramienta
- Compartir una memoria entre Claude Code, Codex y otros agentes mediante Waku Memory
Inicio rápido
- 1
Instala el paquete desde PyPI
pip install waku-agent - 2
Habla con Waku en la terminal (la primera vez te pedirá una API key)
waku - 3
O abre el panel en el navegador en localhost:7777
waku dashboard
Antes de usarlo
- Necesita una API key de un proveedor de modelos (por ejemplo, Anthropic u OpenAI) para funcionar.
Temas
Preguntas frecuentes
- ¿Qué es waku-agent?
- Asistente personal de IA local-first, escrito en Python legible, con su propio bucle de agente, memoria basada en SQLite y evaluaciones integradas. waku-agent es un asistente personal de IA que se ejecuta en tu propia máquina. Se basa en cuatro componentes: un harness que conecta gateways como una terminal, un panel web, Telegram y Discord con un único bucle de agente; un bucle de unas 95 líneas de Python que razona, actúa y repite el proceso; un sistema de memoria semántica, episódica y procedimental (de habilidades); y una capa de evaluación que combina pruebas deterministas con puntuaciones de LLM-as-judge.
- ¿waku-agent es gratuito? ¿Qué licencia tiene?
- waku-agent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿waku-agent sigue mantenido?
- Mantenimiento activo. El último commit de waku-agent fue el 11 oct 2026.
- ¿Para qué puedo usar waku-agent?
- Ejecutar un asistente personal en tu laptop y guardar su memoria localmente Estudiar cómo se integran el bucle de agente, la recuperación de memoria y las evaluaciones en una base de código pequeña Crear un fork del harness para añadir un gateway de mensajería o una herramienta Compartir una memoria entre Claude Code, Codex y otros agentes mediante Waku Memory
- ¿Cómo se instala waku-agent?
- Instala el paquete desde PyPI: pip install waku-agent Habla con Waku en la terminal (la primera vez te pedirá una API key): waku O abre el panel en el navegador en localhost:7777: waku dashboard
- ¿Dónde consigo waku-agent?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ShenSeanChen/waku-agent
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Una aplicación ligera y autohospedada de agente personal, con TUI y GUI, herramientas para espacios de trabajo locales, aprobación humana, sesiones persistentes, memoria y extensiones Skill/Plugin/MCP.
1844PythonMITActualizado hace 20 horas
Agente de IA personal, local y autohospedado, con memoria por capas, permisos para herramientas, flujos de trabajo e integración con canales de mensajería.
1375JavaMITActualizado hace 2 meses
Plataforma autoalojada de agentes de IA persistentes con memoria a largo plazo que colaboran y responden en canales de chat, todo en un solo contenedor.
7116TypeScriptMITActualizado ayer
Arquitectura documentada y plugin instalable de Claude Code para crear un jefe de gabinete con IA, memoria persistente, informes diarios y tareas programadas en segundo plano.
8512HTMLMITActualizado hace 4 días
Agente de sistema operativo personal local-first basado en Hermes que registra el estado de ánimo, el sueño, las comidas y los hábitos, y detecta patrones a lo largo del tiempo.
22016PythonMITActualizado ayer