Repolode
Submit
ntygod

ntygod/ZhiWei

Self-hosted, local-first personal AI agent with layered memory, tool permissions, workflows and IM channel integration.

View on GitHub
Stars
137
Forks
5
Open issues
1
Last commit
2 months ago

What is it?

ZhiWei is a self-hosted AI agent system built with Java and Spring Boot, with a Vue 3 web UI. All data is stored locally under ~/.zhiwei/ in SQLite, using the sqlite-vec extension for vector search, so it needs no external database service.

Memory is organized in four layers: working context, episodic conversation records, semantic knowledge entities and relations, and procedural skill templates and user preferences. The agent runs a ReAct loop (think, call a tool, observe, answer) and can suspend while waiting for confirmation, a scheduled time or external data. It ships with 33 built-in skills covering scheduling, browser automation, sandboxed code execution and knowledge retrieval.

Model calls are split into independent routes for generation, embeddings, reranking and multimodal input, with a circuit breaker and failover. Tool calls are authorized at session, workspace, task or long-term scope. Users can reach it through the web UI, a Tauri desktop client, or Feishu, DingTalk, WeCom and QQ bots, and deploy it via a Windows installer, Docker Compose or from source.

Key features

  • 01Four-layer memory covering working context, conversation history, knowledge graph and reusable skill templates.
  • 02ReAct-style agent loop that can suspend and resume on confirmations, schedules or external events.
  • 03Multi-LLM routing with separate routes for generation, embeddings, reranking and multimodal, plus failover.
  • 04Tiered tool authorization with scopes from single session to long-term, and confirmation for high-risk actions.
  • 05Knowledge base ingestion for PDF, Word and Markdown with hybrid retrieval and optional reranking.
  • 06YAML-defined workflows with cron, event and manual triggers, and MCP protocol support.

Use cases

  • Running a private assistant on your own machine that keeps conversations and notes off third-party clouds.
  • Querying your own PDF, Word or Markdown documents through a retrieval-backed chat.
  • Automating recurring tasks with scheduled jobs, workflows and browser automation.
  • Receiving and replying to messages through Feishu, DingTalk, WeCom or QQ bots.

Topics

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

FAQ

What is ZhiWei?
Self-hosted, local-first personal AI agent with layered memory, tool permissions, workflows and IM channel integration. ZhiWei is a self-hosted AI agent system built with Java and Spring Boot, with a Vue 3 web UI. All data is stored locally under ~/.zhiwei/ in SQLite, using the sqlite-vec extension for vector search, so it needs no external database service.
Is ZhiWei free to use? What license does it have?
ZhiWei is open source under the MIT license. Check the license terms before using it in commercial products.
Is ZhiWei still maintained?
Updated within 6 months. The last commit to ZhiWei was on Aug 11, 2026.
What can I use ZhiWei for?
Running a private assistant on your own machine that keeps conversations and notes off third-party clouds. Querying your own PDF, Word or Markdown documents through a retrieval-backed chat. Automating recurring tasks with scheduled jobs, workflows and browser automation. Receiving and replying to messages through Feishu, DingTalk, WeCom or QQ bots.
Where can I get ZhiWei?
The source code and installation instructions are on GitHub: https://github.com/ntygod/ZhiWei

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects