be-more-agent:树莓派上的100%本地离线语音AI助手,新手完全入门指南

📅 发布时间:2026/10/15 12:58:57
be-more-agent:树莓派上的100%本地离线语音AI助手,新手完全入门指南
【免费下载链接】be-more-agentLocal AI Agent running on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/be/be-more-agent点击查看免费下载be-more-agent是一个专为树莓派Raspberry Pi打造的 100% 本地离线语音 AI 助手它通过唤醒词唤醒用本地 Whisper.cpp 识别语音用 Ollama 运行本地大模型思考再用 Piper TTS 低延迟合成语音回答全程无需联网、不花一分钱 API 费用非常适合想自建离线语音助手的新手。be-more-agent 树莓派离线语音AI助手待机界面一、它为什么值得关注本地离线的 4 大核心能力大多数语音助手依赖云端 API联网才有响应、长期用有费用、语音数据要上传。be-more-agent 把整条 AI 链路都搬到了树莓派本地环节使用的技术说明唤醒OpenWakeWord开源离线唤醒词默认 Hey Jarvis无需密钥听语音转文字Whisper.cpp本地运行不上传录音想大脑Ollama gemma3:1b本地 LLM离线对话说文字转语音Piper TTS低延迟神经语音合成看视觉Moondream摄像头拍照并本地看图说话查联网补充DuckDuckGo本地模型答不上时自动联网搜索它还有一个空白画布设计表情图片和音效都可以整体替换轻松打造自己的专属 AI 角色。二、硬件准备清单树莓派语音助手需要什么按照 README.md 的要求准备以下设备即可开工树莓派 5推荐或 树莓派 4至少 4GB 内存USB 麦克风 扬声器LCD 屏幕DSI 或 HDMI树莓派摄像头模块可选用于视觉功能 树莓派 4 内存低于 4GB 时本地大模型运行会比较吃力建议优先选择 Pi 5。三、安装教程从系统更新到启动 Agent 的 4 个步骤第 1 步更新系统并安装 gitsudo apt update sudo apt upgrade -y sudo apt install git -y第 2 步安装 Ollama 并拉取模型Ollama 是整个 Agent 的大脑运行时curl -fsSL https://ollama.com/install.sh | sh ollama pull gemma3:1b ollama pull moondream第 3 步克隆仓库并运行自动安装脚本git clone https://gitcode.com/gh_mirrors/be/be-more-agent cd be-more-agent chmod x setup.sh ./setup.shsetup.sh 会自动完成 6 件事安装系统依赖库、创建 faces/sounds 目录结构、下载 Piper TTS 引擎、下载语音模型、搭建 Python 虚拟环境并安装 requirements.txt 中的依赖、拉取 Ollama 模型。新手只需等待它跑完即可。第 4 步启动 Agentsource venv/bin/activate python agent.py启动后屏幕会播放开机动画warmup 表情随后进入待机状态对麦克风说出唤醒词Hey Jarvis即可开始对话。如果想自定义唤醒词可以训练一个模型并命名为wakeword.onnx放到项目根目录。be-more-agent 语音助手正在聆听用户说话的表情界面四、配置详解读懂 config.json 的关键参数所有个性化设置都集中在 config.json 中首次运行时 agent.py 会自动生成默认配置。关键参数如下{ text_model: gemma3:1b, vision_model: moondream, voice_model: piper/en_GB-semaine-medium.onnx, chat_memory: true, camera_rotation: 0, system_prompt_extras: You are a helpful robot assistant. }参数作用新手建议text_model对话大脑用的 LLM保持gemma3:1b树莓派上流畅度最佳voice_model语音合成模型想换声音就指向另一个.onnx文件chat_memory是否保留对话历史开启后助手能记住上下文camera_rotation摄像头画面旋转角度相机倒挂时设为 180system_prompt_extras追加人设提示词在这里写性格设定最方便system_prompt中还内置了 3 个工具指令查时间get_time、拍照capture_image、联网搜索search_web大模型答不上时会主动调用。be-more-agent 离线AI助手本地大模型思考时的表情界面五、角色定制替换表情与音效打造专属 AI项目的灵魂藏在两个目录里替换它们就能换掉整个角色形象表情faces/ 下按状态分了 6 个子目录idle待机、listening聆听、thinking思考、speaking说话、error报错、warmup开机。每个子目录放若干张.png程序会自动循环播放。音效sounds/ 下按用途分了 4 类greeting_sounds启动问候、thinking_sounds思考循环音、ack_sounds听到了提示音、error_sounds错误音。每类放多个.wav每次随机挑一个播放。以说话状态为例默认就是这样一组 800x480 的动画序列帧be-more-agent 语音合成回复时的说话状态表情序列帧 想做一个机器人小助手用绘图软件按 7 种状态各画几张图丢进对应文件夹即可无需改一行代码。六、视觉能力让树莓派 AI 助手看见世界连接摄像头后Agent 可以用Moondream视觉模型同样跑在本地 Ollama 里拍照并描述画面——你问我桌上放的是什么它就能回答。拍照画面会保存在current_image.jpg配合camera_rotation参数调整画面朝向。be-more-agent 树莓派摄像头拍照捕捉视觉状态的界面提示视觉问答偶尔需要联网由 DuckDuckGo 补充实时信息这是整个 Agent 唯一会访问外网的环节。七、常见问题排查报错、音效变调一次看懂1. 退出时出现Expression alsa_snd_pcm_mmap_begin failed这是正常现象只表示退出时音频流被截断不影响任何功能直接忽略即可。2. 提示 No search library found说明没在虚拟环境里运行。先执行source venv/bin/activate再用 pip 安装duckduckgo-search即可恢复联网搜索。3. 自定义语音声音低沉慢速这是采样率不匹配的经典症状两步排查打开语音模型的.onnx.json配置查看sample_rate如 22050 / 16000 / 48000将 agent.py 中PIPER_RATE的数值改成相同数字若采样率一致再检查inference里的length_scale把它调回接近1.0即可恢复正常语速。遇到错误状态时Agent 也会播放error表情提醒你be-more-agent 语音助手报错错误状态的提示表情界面八、写在最后适合谁上手如果你满足以下条件be-more-agent 值得一个周末尝试✅ 有一台树莓派 4/5想折腾一个离线语音 AI 助手✅ 不想按量付费、不想把语音数据传给云端✅ 喜欢换装式玩法换表情、换音效、换人设做独一无二的桌面 AI 角色项目采用 MIT 协议开源见 LICENSE桌面快捷方式 be-more-agent.desktop 也方便你把它挂到系统菜单里一键启动。动手试试吧——一个完全属于你的、不联网的 AI 小伙伴就在 agent.py 里等着醒来。赞分享【免费下载链接】be-more-agentLocal AI Agent running on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/be/be-more-agent点击查看免费下载相关推荐be-more-agent语音识别深度解析whisper.cpp如何实现树莓派上的离线语音转文字be more agent语音识别深度解析whisper.cpp如何实现树莓派上的离线语音转文字 be more agent 是一个运行在树莓派RaspbeVosk-api在树莓派上的离线语音识别实践指南Vosk api在树莓派上的离线语音识别实践指南 前言 Vosk作为一个开源的离线语音识别工具包因其跨平台特性支持Linux、Windows、Android人工智能语音Atomic Chat完全入门指南如何100%离线运行本地大模型打造你的私有AI助手Atomic Chat完全入门指南如何100%离线运行本地大模型打造你的私有AI助手 Atomic Chat 是一款开源的本地AI应用与推理引擎让你在自己创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考