Repolode
Enviar
ntygod

ntygod/ZhiWei

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.

Ver no GitHub
Estrelas
137
Forks
5
Issues abertas
1
Último commit
há 2 meses

O que é?

ZhiWei é um sistema de agente de IA auto-hospedado, desenvolvido com Java e Spring Boot e com uma interface web em Vue 3. Todos os dados ficam armazenados localmente em ~/.zhiwei/, no SQLite, com a extensão sqlite-vec para busca vetorial — sem necessidade de um serviço de banco de dados externo.

A memória é organizada em quatro camadas: contexto de trabalho, registros episódicos de conversas, entidades e relações de conhecimento semântico, e templates de habilidades procedurais e preferências do usuário. O agente executa um loop ReAct (pensar, chamar uma ferramenta, observar, responder) e pode suspender a execução enquanto aguarda uma confirmação, um horário agendado ou dados externos. O sistema inclui 33 habilidades integradas para agendamento, automação de navegador, execução de código em sandbox e recuperação de conhecimento.

As chamadas a modelos usam rotas independentes para geração, embeddings, reranking e entrada multimodal, com circuit breaker e failover. As chamadas a ferramentas são autorizadas nos escopos de sessão, workspace, tarefa ou longo prazo. É possível acessar o agente pela interface web, por um cliente desktop Tauri ou por bots do Feishu, DingTalk, WeCom e QQ. A implantação pode ser feita por um instalador para Windows, com Docker Compose ou a partir do código-fonte.

Recursos principais

  • 01Memória em quatro camadas, com contexto de trabalho, histórico de conversas, grafo de conhecimento e templates reutilizáveis de habilidades.
  • 02Loop de agente no estilo ReAct que pode suspender e retomar a execução após confirmações, em horários agendados ou diante de eventos externos.
  • 03Roteamento para vários LLMs, com rotas separadas para geração, embeddings, reranking e entrada multimodal, além de failover.
  • 04Autorização de ferramentas por níveis, com escopos que vão de uma única sessão ao longo prazo e confirmação para ações de alto risco.
  • 05Ingestão de documentos PDF, Word e Markdown para a base de conhecimento, com recuperação híbrida e reranking opcional.
  • 06Workflows definidos em YAML, com gatilhos cron, por evento e manuais, além de suporte ao protocolo MCP.

Casos de uso

  • Executar um assistente privado na própria máquina, mantendo conversas e anotações fora das nuvens de terceiros.
  • Consultar documentos PDF, Word ou Markdown próprios por meio de um chat com recuperação de informações.
  • Automatizar tarefas recorrentes com jobs agendados, workflows e automação de navegador.
  • Receber e responder mensagens por meio de bots do Feishu, DingTalk, WeCom ou QQ.

Início rápido

  1. 1

    Clone o repositório

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

    Crie o arquivo .env e preencha com sua chave de API de LLM

    cp .env.example .env
  3. 3

    Inicie os serviços com Docker Compose e abra http://localhost

    docker compose up -d

Antes de usar

  • É necessário configurar pelo menos um provedor de LLM antes de usar o chat.
  • O design é para um único usuário e não oferece suporte a contas multiusuário nem isolamento de permissões.
  • O armazenamento SQLite é adequado para uso pessoal e não oferece suporte à implantação em cluster.
  • A automação de navegador com Playwright é opcional e requer a instalação separada do pacote de driver.

Tópicos

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

Perguntas frequentes

O que é ZhiWei?
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. ZhiWei é um sistema de agente de IA auto-hospedado, desenvolvido com Java e Spring Boot e com uma interface web em Vue 3. Todos os dados ficam armazenados localmente em ~/.zhiwei/, no SQLite, com a extensão sqlite-vec para busca vetorial — sem necessidade de um serviço de banco de dados externo.
ZhiWei é gratuito? Qual é a licença?
ZhiWei é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ZhiWei ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de ZhiWei foi em 11 de ago. de 2026.
Para que posso usar ZhiWei?
Executar um assistente privado na própria máquina, mantendo conversas e anotações fora das nuvens de terceiros. Consultar documentos PDF, Word ou Markdown próprios por meio de um chat com recuperação de informações. Automatizar tarefas recorrentes com jobs agendados, workflows e automação de navegador. Receber e responder mensagens por meio de bots do Feishu, DingTalk, WeCom ou QQ.
Como instalar ZhiWei?
Clone o repositório: git clone https://github.com/ntygod/ZhiWei.git && cd ZhiWei Crie o arquivo .env e preencha com sua chave de API de LLM: cp .env.example .env Inicie os serviços com Docker Compose e abra http://localhost: docker compose up -d
Onde consigo ZhiWei?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ntygod/ZhiWei

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados