B

实时看懂屏幕、会做表情的桌面 AI 伴侣

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 音频音乐 🍴 复刻 3 👀 关注 1
GitHub ↗
GitHub 星标 ★ 5199
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

B 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类音频音乐
开发团队AhmadHassan-BTed
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai,ai-agent,ai-companion,artificial-intelligence,autonomous-agent,computer-vision,desktop-assistant,llm,onnx,python,speech-to-text,text-to-speech
GitHub 星标★ 5199
上线时间2026-05-02 00:00:00
代码更新2026-07-07
仓库体积64.1 MB
本站数据更新2026-11-10
维护状态低维护
收录时间2026-08-09
浏览次数7

项目介绍

B 是一个用 Python 构建的自主上下文感知 AI 桌面伴侣。它通过实时屏幕视觉、自定义 ONNX 语音合成、活动窗口跟踪和带反应式面部表情的动态浮动 UI,提供沉浸式陪伴体验。项目旨在解决传统桌面助手缺乏环境感知和情感交互的问题,核心能力包括:实时识别屏幕内容以理解用户上下文,基于 ONNX 的本地语音合成实现自然语音输出,跟踪当前活动窗口以提供情境化建议,以及通过浮动 UI 上的面部表情增强情感连接。它适合作为个人 AI 伴侣、桌面生产力辅助工具或情感交互实验平台。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5199

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:本地安装 6 步

环境要求

  • Python 环境(README 使用 python -m venv,未标注具体版本号)
  • Git(用于克隆仓库)
  • 有效的 Groq API Key,可从 https://console.groq.com/ 获取
  • 可访问互联网以安装 requirements.txt 中的依赖

安装与启动步骤

  1. 1克隆仓库

    使用 git 拉取项目代码并进入项目根目录,后续命令都在此目录执行。

    git clone https://github.com/Ahmad-Hassan-0/B---desktop-companion.git
    cd B---desktop-companion
  2. 2创建虚拟环境

    在项目目录内创建名为 venv 的 Python 虚拟环境,隔离依赖。

    python -m venv venv
  3. 3激活虚拟环境

    Windows 执行 venv\Scripts\activate,Linux/macOS 执行 source venv/bin/activate。

    source venv/bin/activate
  4. 4安装依赖

    按 requirements.txt 安装项目所需的全部 Python 包,需联网。

    pip install -r requirements.txt
  5. 5配置 API Key

    复制环境变量模板为 .env,并填入你自己的 Groq API Key。

    cp .env.example .env
  6. 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···

★ 838 2026-08-09
sillytavern-DeepLore 开源

让 SillyTavern 自动从 Obsidian 笔记中检索并注入设定,告别手动翻书

AI-powered lorebook engine for SillyTavern. It retrieves relevant lore from your Obs···

★ 93 2026-08-09
Deep-Research-AI-Agent 开源

输入主题,自动追问、搜索、写报告,一键生成深度调研结果。

Build a powerful Deep Research AI agent like Gemini or ChatGPT. Using Next.js, Verce···

★ 163 2026-08-09
talon 开源

一个框架,让 AI 代理在多个聊天平台和终端里持续干活。

Multi-platform agentic AI harness — runs on Telegram, Discord, Teams & Terminal wit···

★ 70 2026-08-09
hermes-hud 开源

在终端里实时查看智能体运行状态,调试更直观。

TUI consciousness monitor for Hermes

★ 933 2026-08-09
agent-search-mcp 开源

免密钥中英文搜索,让智能体秒得证据

Free-first Chinese and English web search MCP using zero-key sources and inspectable···

★ 113 2026-08-09
VibeDrift 开源

让 AI 写代码不跑偏,实时自检保持架构一致

Ship agentic. Stay coherent. Self-checking code integrity for AI coding agents, via ···

★ 60 2026-08-09
turbular 开源

让 AI 一句话查遍所有数据库

A MCP server allowing LLM agents to easily connect and retrieve data from any databa···

★ 98 2026-08-09