WhatsApp消息同步与搜索服务

Lilith WhatsApp是一款将WhatsApp历史消息和实时消息同步到PostgreSQL数据库,并通过Python MCP服务器提供搜索功能的服务。

  • by Agent-Lilith
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Agent-Lilith/lilith-whatsapp

使用说明

Lilith WhatsApp

Lilith代理的WhatsApp上下文:Baileys v7将历史和实时消息同步到PostgreSQL中;Python MCP服务器公开搜索。

快速开始

1.数据库(共享Postgres)

此项目使用 共享 PostgreSQL服务器。此应用程序的数据库名称: lilith_whatsapp.

确保共享的Postgres(带pgvector)正在运行。先克隆莉莉丝作曲项目。

2.运行迁移

uv run alembic upgrade head

3.首次WhatsApp身份验证(历史同步)

阅读wa连接器文件夹中的README文件。

4.进行预埋回填

Node应用程序会 不 嵌入消息文本。要启用向量搜索,请运行Python回填,以便 body_embedding 填充自 body_text:

uv run python main.py embed

5.运行消息侦听器(进行中)

捕捉 新 信息:

cd wa-connector
npm run listen

使用相同 AUTH_STATE_DIR 如步骤3所示,因此它重用相同的会话。

测试

uv sync --extra dev
uv run pytest tests/ -v

单元测试在没有数据库的情况下运行。集成测试(针对Pouyan的LID/PN的接触分辨率、统一搜索)需要 DATABASE_URL; .env 在项目中,根是自动加载的,因此您不需要导出它。它们被标记为 integration;跳过它们:

uv run pytest tests/ -v -m "not integration"

MCP服务器(代理工具)

Lilith WhatsApp MCP服务器。

uv run mcp
uv run mcp --transport streamable-http --port 6201