explaingit

kkkirito-123/zlagent

Analysis updated 2026-05-18

14PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

ZLAgent is a personal AI assistant that chats with you inside WeChat, WeCom, or webhook platforms, remembering your preferences and building a knowledge graph over time.

Mindmap

mindmap
  root((ZLAgent))
    What it does
      IM based AI assistant
      Remembers preferences
      Builds knowledge graph
    Tech stack
      Python and FastAPI
      PostgreSQL and Neo4j
      Redis and Docker
    Features
      15 built in tools
      MCP tool installs
      Permission levels
    Platforms
      WeChat
      WeCom
      Webhook

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Chat with a persistent AI assistant directly inside WeChat, WeCom, or any webhook-based messaging platform.

USE CASE 2

Let the assistant remember your preferences and past facts across conversations without repeating yourself.

USE CASE 3

Install new tools mid-conversation by describing what you need, using the MCP tool standard.

What is it built with?

PythonFastAPIPostgreSQLNeo4jRedisDocker

How does it compare?

kkkirito-123/zlagent0c33/agentic-aiadennng/stock_strategy_lab
Stars141414
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Docker Compose to run the API server alongside PostgreSQL, Neo4j, and Redis together.

MIT License, use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

In plain English

ZLAgent is a personal AI assistant that lives inside messaging apps, specifically WeChat, WeCom, the enterprise version of WeChat, or any webhook-compatible chat platform. Instead of opening a separate app or website to talk to an AI, you chat with it like a contact right inside the IM platform you already use. The assistant is designed to grow smarter over time through three kinds of stored knowledge: long-term memory, your preferences and habits, stored in PostgreSQL, an answer and fact cache for repeated questions it has already worked out, managed in a wiki subsystem, and a knowledge graph of structured relationships extracted from conversations and documents, stored in Neo4j. Together these let it remember you across sessions, skip recomputing answers it already knows, and follow connections between related facts. It also has a skill and tool system. Fifteen built-in tools cover things like memory management, scheduling tasks, web search, reading URLs, running code, and sending messages. You can extend it further by installing MCP tools, a standard for connecting AI agents to external software, through a natural-language request in the chat, with no configuration files to edit manually. Tools have three permission levels: safe ones run automatically, confirm-level ones pause and ask you before running, and deny-level ones are blocked entirely. The whole stack runs via Docker with a single command, spinning up the API server, PostgreSQL, Neo4j, and Redis together. The primary language is Python, using FastAPI for the web layer, and the project is released under the MIT License. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me deploy ZLAgent with Docker and connect it to WeChat.
Prompt 2
Explain how ZLAgent's long-term memory, wiki cache, and knowledge graph work together.
Prompt 3
How do I install a new MCP tool into ZLAgent just by asking it in chat?
Prompt 4
What are the three permission levels for tools in ZLAgent and how do they affect what runs automatically?

Frequently asked questions

What is zlagent?

ZLAgent is a personal AI assistant that chats with you inside WeChat, WeCom, or webhook platforms, remembering your preferences and building a knowledge graph over time.

What language is zlagent written in?

Mainly Python. The stack also includes Python, FastAPI, PostgreSQL.

What license does zlagent use?

MIT License, use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is zlagent to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is zlagent for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.