Whatsapp AI Agent Fluxi

您的 WhatsApp 私人人工智能。我…

Dashboard

______________________________________________________________________

🤔 为什么流动？

你以前想在 WhatsApp 上安装 AI 助理，但：

• 不想支付SaaS平台的月费
• 不依赖外部服务器
• 不想把你的谈话暴露给第三方
• 想要完全控制AI行为

流动解决了这一切。

使用Docker，本地语言模型（LM Studio，Ollama）和您的WhatsApp号码，您可以在几分钟内运行100%私有的人工智能。

______________________________________________________________________

🚀 你可以建立什么

流量结合 WhatsApp+RAG+工具+MCP+IA （本地或云端）这打开了远远超出简单聊天机器人的可能性。

👤 个人助理

🏢 业务自动化

🔧 技术集成

🎨 创造性使用

______________________________________________________________________

🛠️ 创建自己的集成

你不局限于现成的工具。Fluxi是为开发人员连接任何东西而设计的。

通过MCP（模型上下文协议）

Crie um servidor MCP em qualquer linguagem e conecte ao Fluxi.
O agente terá acesso às suas ferramentas automaticamente.

您可以创建的 MCP 示例：

• 查询您的内部数据库
• 与您的ERP/CRM集成
• IoT 设备控制
• 访问公司内部 API

例如：MCP Diet

该项目包括一个功能示例 exemplo_mcp/dieta_mcp.py:

1.启动或MCP服务器：

cd exemplo_mcp
python dieta_mcp.py

2.不配置Fluxi：

访问 http://localhost:8000/mcp/agente/{id}/json-config 并添加 ：

{
  "mcpServers": {
    "dieta": {
      "serverUrl": "http://localhost:8002/sse"
    }
  }
}

3. 通过WhatsApp使用：

Você: Registra meu almoço: arroz, feijão e frango, 650 calorias
IA: Refeição registrada! Almoço: arroz, feijão e frango (650 kcal)

Você: Quanto já comi hoje?
IA: TOTAL DO DIA: 1200 kcal

Você: Como estou na meta?
IA: Consumido: 60% da meta. Restante: 800 kcal

查看更多详情 exemplo_mcp/README.md

通过API REST（Ferrametas）

Use o Wizard visual para criar ferramentas que chamam suas APIs.
Sem código - configure método, headers, body e mapeie a resposta.

当然，向导支持：

• 任何HTTP方法（GET，POST，PUT，DELETE）
• 身份验证（Bearer、API Key、Basic）
• 对话上下文的动态变量
• 响应转换（ JsonPath）

通过Python代码

Para lógicas complexas, crie ferramentas CODE que executam Python.
Ideal para cálculos, validações ou transformações de dados.

______________________________________________________________________

🧠 选择你的AI

智利使用本地模型进行敏感对话，使用云模型进行复杂任务。Fluxi 支持自动备份 。

______________________________________________________________________

⚡ 功能

______________________________________________________________________

📸 截图

|MCP客户端| |-------------| | MCP |

______________________________________________________________________

🏁 如何开始

要求

• 码头安装
• 一个WhatsApp号码
• LLM提供商（本地或云）

1.克隆和配置

git clone https://github.com/jjhoow/fluxi.git
cd fluxi
cp config.example.env .env

2.Inicie com Docker

docker-compose up -d --build

3. 登录并连接

1. 打开 http://localhost:8000
2. 创建 WhatsApp 会话
3. Escaneie或二维码
4. 配置 LLM 提供程序
5. 创建您的第一个代理

Pronto。 向连接的号码发送消息。

______________________________________________________________________

🔩 堆栈技术

______________________________________________________________________

📂 建筑

fluxi/
├── agente/          # Sistema de agentes inteligentes
├── config/          # Configurações do sistema
├── ferramenta/      # Ferramentas customizadas (function calling)
├── llm_providers/   # Provedores LLM (local e nuvem)
├── mcp_client/      # Model Context Protocol
├── mensagem/        # Mensagens e histórico
├── metrica/         # Analytics e monitoramento
├── rag/             # Bases de conhecimento
├── sessao/          # Sessões WhatsApp
└── templates/       # Interface web

每个模块都有自己的文档 [modulo]/README.md.

______________________________________________________________________

📋 更新日志

v0.2.0 - 2025年11月

新资源

• 暗模式na界面
• 每个会话可自定义的命令 （#ativar, #desativar)
• 可配置的消息类型（ 忽略、 固定回复等）
• 支持多模式消息（文本+图像）

改进

• 消息历史记录包括向导的回复
• 自动同步新命令
• 所有模块的最新文档

修正

• 命令 #desativar 未被正确识别
• 多模式历史记录没有发送到LLM

v0.1.0 - 2025年10月

• 初始启动
• COM系统提示符代理系统
• 使用向导自定义工具
• RAG com ChromaDB
• MCP 集成
• 多供应商LLM
• 界面web组件

______________________________________________________________________

🤝 贡献

欢迎捐款！

1. 分叉工程
2. 创建分支（git checkout -b feature/nova-feature)
3. 提交您的更改（git commit -m 'Adiciona nova feature')
4. 推(git push origin feature/nova-feature)
5. Abra um Pull请求

______________________________________________________________________

💬 社区

• Bugs和建议
• 疑问和想法

______________________________________________________________________

📦 第三方依赖关系

这个项目使用：

• neonize -WhatsApp网站的Python客户端
• 怎么回事 -WhatsApp网站Go图书馆（通过Neonize）
• 快速API -框架web
• 色度数据库 - 矢量银行
• SQLAlchemy -ORM

______________________________________________________________________

🙏 致谢

• 快速API 令人难以置信的框架
• 霓虹灯 如何使 WhatsApp 在 Python 中可用
• 色度数据库 通过简单而强大的矢量银行
• 开放源代码社区的所有图书馆，使这一切成为可能

______________________________________________________________________

📄 许可证

Apache 2.0 - 查看 许可证 为了细节。

______________________________________________________________________

专为那些想要完全控制AI的人而设计。

如果这个项目帮助了你，留下一颗星！