Repolode
Enviar
ntygod

ntygod/ZhiWei

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.

Ver en GitHub
Estrellas
137
Forks
5
Issues abiertos
1
Último commit
hace 2 meses

¿Qué es?

ZhiWei es un sistema de agentes de IA autohospedado, desarrollado con Java y Spring Boot, y con una interfaz web en Vue 3. Todos los datos se guardan localmente en ~/.zhiwei/ en SQLite, con la extensión sqlite-vec para búsquedas vectoriales, por lo que no necesita un servicio de base de datos externo.

La memoria se organiza en cuatro capas: contexto de trabajo, registros de conversaciones episódicas, entidades y relaciones de conocimiento semántico, y plantillas de habilidades procedimentales y preferencias del usuario. El agente ejecuta un ciclo ReAct (pensar, llamar a una herramienta, observar y responder) y puede suspenderse mientras espera una confirmación, una hora programada o datos externos. Incluye 33 habilidades integradas para gestionar horarios, automatizar el navegador, ejecutar código en un entorno aislado y recuperar conocimiento.

Las llamadas a modelos se dividen en rutas independientes para generación, embeddings, reranking y entrada multimodal, con un disyuntor y mecanismos de conmutación por error. Las llamadas a herramientas se autorizan con alcance de sesión, espacio de trabajo, tarea o largo plazo. Se puede acceder al agente desde la interfaz web, un cliente de escritorio Tauri o bots de Feishu, DingTalk, WeCom y QQ; también se puede implementar mediante un instalador para Windows, Docker Compose o desde el código fuente.

Funciones clave

  • 01Memoria de cuatro capas que abarca el contexto de trabajo, el historial de conversaciones, el grafo de conocimiento y las plantillas de habilidades reutilizables.
  • 02Ciclo de agente al estilo ReAct que puede suspenderse y reanudarse ante confirmaciones, tareas programadas o eventos externos.
  • 03Enrutamiento entre varios LLM con rutas independientes para generación, embeddings, reranking y entrada multimodal, además de mecanismos de conmutación por error.
  • 04Autorización de herramientas por niveles, con alcances desde una única sesión hasta el largo plazo y confirmación para acciones de alto riesgo.
  • 05Ingesta de documentos PDF, Word y Markdown en la base de conocimiento, con recuperación híbrida y reranking opcional.
  • 06Flujos de trabajo definidos en YAML con activadores cron, por eventos y manuales, además de compatibilidad con el protocolo MCP.

Casos de uso

  • Usar un asistente privado en tu propio equipo que mantenga las conversaciones y notas fuera de las nubes de terceros.
  • Consultar tus propios documentos PDF, Word o Markdown mediante un chat con recuperación de información.
  • Automatizar tareas recurrentes con trabajos programados, flujos de trabajo y automatización del navegador.
  • Recibir y responder mensajes mediante bots de Feishu, DingTalk, WeCom o QQ.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/ntygod/ZhiWei.git && cd ZhiWei
  2. 2

    Crea el archivo .env e introduce tu clave de API de LLM

    cp .env.example .env
  3. 3

    Inicia los servicios con Docker Compose y abre http://localhost

    docker compose up -d

Antes de usarlo

  • Es necesario configurar al menos un proveedor de LLM antes de poder usar el chat.
  • Está diseñado para un solo usuario y no admite cuentas multiusuario ni aislamiento de permisos.
  • El almacenamiento con SQLite es adecuado para uso personal y no admite despliegues en clúster.
  • La automatización del navegador con Playwright es opcional y requiere instalar el paquete del controlador por separado.

Temas

#personal-agent#ai-agent#local-first#self-hosted#sqlite#spring-boot#personal-assistant#vue

Preguntas frecuentes

¿Qué es ZhiWei?
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. ZhiWei es un sistema de agentes de IA autohospedado, desarrollado con Java y Spring Boot, y con una interfaz web en Vue 3. Todos los datos se guardan localmente en ~/.zhiwei/ en SQLite, con la extensión sqlite-vec para búsquedas vectoriales, por lo que no necesita un servicio de base de datos externo.
¿ZhiWei es gratuito? ¿Qué licencia tiene?
ZhiWei es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ZhiWei sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de ZhiWei fue el 11 ago 2026.
¿Para qué puedo usar ZhiWei?
Usar un asistente privado en tu propio equipo que mantenga las conversaciones y notas fuera de las nubes de terceros. Consultar tus propios documentos PDF, Word o Markdown mediante un chat con recuperación de información. Automatizar tareas recurrentes con trabajos programados, flujos de trabajo y automatización del navegador. Recibir y responder mensajes mediante bots de Feishu, DingTalk, WeCom o QQ.
¿Cómo se instala ZhiWei?
Clona el repositorio: git clone https://github.com/ntygod/ZhiWei.git && cd ZhiWei Crea el archivo .env e introduce tu clave de API de LLM: cp .env.example .env Inicia los servicios con Docker Compose y abre http://localhost: docker compose up -d
¿Dónde consigo ZhiWei?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ntygod/ZhiWei

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados