
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5199
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境(README 使用 python -m venv,未标注具体版本号)
- Git(用于克隆仓库)
- 有效的 Groq API Key,可从 https://console.groq.com/ 获取
- 可访问互联网以安装 requirements.txt 中的依赖
安装与启动步骤
-
1克隆仓库
使用 git 拉取项目代码并进入项目根目录,后续命令都在此目录执行。
git clone https://github.com/Ahmad-Hassan-0/B---desktop-companion.git cd B---desktop-companion -
2创建虚拟环境
在项目目录内创建名为 venv 的 Python 虚拟环境,隔离依赖。
python -m venv venv -
3激活虚拟环境
Windows 执行 venv\Scripts\activate,Linux/macOS 执行 source venv/bin/activate。
source venv/bin/activate -
4安装依赖
按 requirements.txt 安装项目所需的全部 Python 包,需联网。
pip install -r requirements.txt -
5配置 API Key
复制环境变量模板为 .env,并填入你自己的 Groq API Key。
cp .env.example .env -
6启动 B
在已激活虚拟环境且填好 .env 的前提下运行主程序,唤醒桌面伴侣。
python main.py
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
GROQ_API_KEY | 是 | README 要求在 .env 中填入 Groq API Key,变量名以 .env.example 为准 | gsk_xxxxxxxxxxxxxxxx |
如何确认成功
执行 python main.py 后,桌面出现 B 的浮动玻璃拟态界面与表情,即表示启动成功。
常见问题
Q:Groq API Key 从哪里获取?
A:访问 README 给出的 https://console.groq.com/ 控制台,注册后创建并复制 API Key,填入 .env 文件。
Q:Windows 上激活虚拟环境应执行什么?
A:在项目目录下执行 venv\Scripts\activate;Linux/macOS 则执行 source venv/bin/activate。
Q:项目支持哪些操作系统?
A:README 同时给出了 Windows 与 Linux/macOS 的虚拟环境激活命令,说明这三类系统均可运行。
Q:必须配置 API Key 才能启动吗?
A:README 将“Configure API keys”列为安装的必要步骤,因此建议先填好 .env 中的 Groq API Key 再运行。
注意事项
- README 未写明所需 Python 版本,建议使用较新的 Python 3.x 并先确认 python -m venv 可用。
- Groq API Key 属于敏感信息,请勿提交 .env 到 Git 仓库。
- 启动命令需在项目根目录执行,且执行前务必已激活 venv,否则可能找不到依赖。
- README 未提供端口、启动日志等验证方式,以桌面端是否出现浮动界面为准。
核心亮点
- 实时屏幕视觉理解用户当前操作,提供上下文相关的响应
- 本地 ONNX 语音合成,无需云端,保护隐私且响应快
- 动态浮动 UI 带面部表情,增强情感交互体验
不足之处
- 早期项目,功能稳定性和生态成熟度待验证
- 文档/社区待观察
适用场景
- 作为个人桌面 AI 伴侣,提供陪伴和日常提醒
- 辅助多任务处理,根据屏幕内容主动提供信息
- 用于情感计算和人机交互研究实验
替代项目
Kara、Open Interpreter、Desktop Assistant
上一篇:mcp-tts
下一篇:lotei-qflipper
同类项目推荐
open-webui-tools
开源
给 Open WebUI 装上 15 个工具,语音音乐能力一键扩展
Open‑WebUI Tools is a modular toolkit designed to extend and enrich your Open WebUI···
让 SillyTavern 自动从 Obsidian 笔记中检索并注入设定,告别手动翻书
AI-powered lorebook engine for SillyTavern. It retrieves relevant lore from your Obs···
Deep-Research-AI-Agent
开源
输入主题,自动追问、搜索、写报告,一键生成深度调研结果。
Build a powerful Deep Research AI agent like Gemini or ChatGPT. Using Next.js, Verce···
talon
开源
一个框架,让 AI 代理在多个聊天平台和终端里持续干活。
Multi-platform agentic AI harness — runs on Telegram, Discord, Teams & Terminal wit···
hermes-hud
开源
在终端里实时查看智能体运行状态,调试更直观。
TUI consciousness monitor for Hermes
agent-search-mcp
开源
免密钥中英文搜索,让智能体秒得证据
Free-first Chinese and English web search MCP using zero-key sources and inspectable···
awesome-multi-agent-papers
开源
一站式速览多智能体核心论文,紧跟前沿不迷路
A compilation of the best multi-agent papers
VibeDrift
开源
让 AI 写代码不跑偏,实时自检保持架构一致
Ship agentic. Stay coherent. Self-checking code integrity for AI coding agents, via ···
turbular
开源
让 AI 一句话查遍所有数据库
A MCP server allowing LLM agents to easily connect and retrieve data from any databa···