语音购物清单管理工具

MCP - 主控程序（或主控制程序）

基于Python、LangChain和Ollama构建的智能语音助手，用于管理购物清单。

功能

• 语音控制： 使用自然语言语音命令添加、删除、列出和发送项目。
• 数据持久性： 购物清单被保存在一个文件中 .xlsx，支持数量。
• 本地人工智能： 它使用通过Ollama在本地运行的大型语言模型（LLM）来解析指令。
• 与WhatsApp集成： 通过链接将格式化的购物清单发送到WhatsApp wa.me。
• 通过终端执行： 简洁直接的命令行界面。

设置与执行

1. 克隆仓库：

   复制

   git clone [https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git](https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git)
   cd NOME_DO_REPOSITORIO
   

2. 创建并激活一个虚拟环境：

   复制

   python -m venv venv
   source venv/bin/activate  # ou venv\Scripts\activate no Windows
   

3. 安装依赖项：

   复制

   pip install -r requirements.txt
   

4. 使用Ollama下载一个大型语言模型（LLM）：

   复制

   ollama pull mistral
   

   如果没有在电脑上安装，可以在这里下载：https://ollama.com/download

5. 执行程序：

   复制

   python main.py
   

项目结构

该项目采用模块化设计以实现职责分离：

• main.py应用程序的入口点和主循环。
• config.py全局常量和设置，包括提示模板。
• shopping_list.pyExcel文件逻辑的管理。
• tools.py工具定义（@tool) 用于LangChain代理。
• agent_setup.py构建和配置ReAct代理。
• voice_controller.py语音识别逻辑（STT）和语音合成（TTS）。
• command_parser.py用于命令解析的辅助函数。