saikiranthatikonda-coder/Avengers-Bobbiey-UCS

## 🌐 在线访问 - **产品官网 / 候补名单：** **https://avengers-bobbiey.netlify.app/** - **指挥中心本体**在**您的本地机器上**运行（设计上隐私优先）—— 请参阅 [快速开始](#-quick-start)。 ## 📸 截图 仪表盘的实时截图保存在 [`docs/screenshots/`](docs/screenshots/) 中。指挥中心是一个充满电影感的暗色 HUD：中央是一个带有实时旋转地球的反应堆球体，八张 AI agent 卡片，实时遥测数据迷你图，六域威胁雷达，世界活动地图，以及印度/特伦甘纳区域网格 —— 所有这些都通过 WebSockets 实时更新。 ## ⚡ 它的功能 Bobbiey UCS 将被动的仪表盘变成了一个**主动的运营大脑**： - 🧠 **8 个专业的 AI agent**（Jarvis · Captain · Stark · Black Widow · Hawkeye · Hulk · Thor · Vision），它们负责观察、总结并提出建议 —— 每个 agent 都具有实时状态、任务、置信度和历史记录。 - 🎙️ **语音命令** —— 每个 agent 专属的唤醒词（“Hey Stark”、“Hey Cap”…），基于 faster-whisper 的 STT，语音回复，以及通过语音控制仪表盘（“open threat intelligence”）。 - 📊 **实时遥测** —— 每 2 秒通过 WebSockets 流式传输 CPU / 内存 / 磁盘 / 网络 / 进程数据，并提供 15 分钟的预测性预报。 - 📅 **日历智能** —— 真正的 Google Calendar 同步、会议倒计时、冲突检测、专注区块分析、准备就绪度评分，以及语音/视觉提醒。 - 🛰️ **威胁情报中心** —— 六域风险矩阵（雷达）、SOC 计数器、事件响应时间线、实时风险评分，以及一个四级的**紧急警报系统**（信息 → 警告 → 严重 → 紧急），带有循环的听觉警报和确认/消除功能。 - 👁️ **视觉感知** —— 无身份识别的摄像头在线状态检测（活跃 / 空闲 / 离开）、会话跟踪、动作计量。_永远不进行人脸识别。_ - 🤖 **本地优先 AI** —— 运行在 **Ollama**（Llama 3, Qwen, Mistral, Phi, DeepSeek…）或 Claude CLI 上，配备可自动检测已安装模型的 UI 内模型管理器。 - 🌍 **实时世界视图** —— 球体核心中旋转的 d3 地球仪、全球活动地图、印度 + 特伦甘纳区域网格、世界时钟，以及海得拉巴的实时天气。 - 🚨 **JARVIS Insights** —— 一个能够读取所有小部件并呈现最有用观察结果的引擎，外加每日高管简报（语音播报）。 ## 🚀 快速开始 ### Windows ``` # 1. clone git clone https://github.com/saikiranthatikonda-coder/Avengers-Bobbiey-UCS.git cd Avengers-Bobbiey-UCS # 2. launch（双击 start-jarvis.cmd，或者：） .\start-jarvis.cmd ``` ### macOS / Linux ``` git clone https://github.com/saikiranthatikonda-coder/Avengers-Bobbiey-UCS.git cd Avengers-Bobbiey-UCS chmod +x start-jarvis.sh ./start-jarvis.sh ``` 仪表盘会在 **http://127.0.0.1:8765** 自动打开。使用 **Ctrl+C** 停止。 就这么简单 —— 它在零配置下即可运行。以下所有内容都是**可选的**，用于解锁更多强大功能。 ## ⚙️ 配置 将 `.env.example` 复制为 `.env`（启动器会为您完成此操作），然后根据需要设置以下内容： | 变量 | 用途 | 默认值 | |---|---|---| | `NEWSAPI_KEY` | 实时世界新闻源 —— 在 [newsapi.org](https://newsapi.org/register) 获取免费密钥 | _(留空 → 使用模拟信息流)_ | | `JARVIS_TTS` | 语音回复 | `1` | | `JARVIS_VOICE` | 唤醒词监听（需要麦克风及额外的依赖项） | `0` | | `JARVIS_WHISPER_MODEL` | STT 模型 (`tiny.en`, `base.en`, `small`) | `small` | | `LOCAL_LLM_URL` | Ollama / OpenAI 兼容的 endpoint | `http://127.0.0.1:11434/v1` | | `LOCAL_LLM_MODEL` | 指定模型（否则自动检测） | _(自动)_ | | `CLAUDE_BIN` | Claude CLI 的路径（备选大脑） | `claude` | ### 可选集成

🤖 结合 Ollama 的本地 AI（推荐 —— 完全离线）

``` # 从 https://ollama.com install Ollama，然后： ollama pull llama3.2 # or qwen, mistral, phi, deepseek... ollama serve ``` 打开仪表盘 → 点击 **MODEL** 行或 **LLM CORE** 扫描磁贴 → 选择您的模型。该选择在重启后依然有效。

📅 Google Calendar

1. [console.cloud.google.com](https://console.cloud.google.com) → 新建项目 → 启用 **Google Calendar API**。 2. 创建 **OAuth 客户端凭据**（桌面应用最简单）→ 下载 JSON → 在项目根目录中保存为 `credentials.json`。 3. 在仪表盘中点击 AGENDA 旁边的 **G** 按钮 → 在浏览器中批准授权。真实事件将流入，每 5 分钟同步一次。 _`credentials.json` 和 `token.json` 已被 gitignored —— 它们永远不会离开您的设备。_

🎙️ 唤醒词语音

``` .venv/bin/pip install faster-whisper sounddevice # (Scripts\pip on Windows) ``` 在 `.env` 中设置 `JARVIS_VOICE=1`，重启，然后说 **"Hey Jarvis"**。

## 🎙️ 语音命令 | 说什么 | 结果 | |---|---| | "Hey Jarvis / Stark / Cap / Widow / Hawkeye / Hulk / Thor / Vision …" | 路由至该 agent | | "What meetings do I have today?" | 实时日历摘要 | | "Summarize my inbox" | 收件箱分类 | | "What's the threat status?" | 风险简报 | | "Open threat intelligence / map / camera …" | 仪表盘控制 | ## 🏗️ 架构 ``` Browser HUD (index.html · app.js · style.css) │ WebSocket /ws (live events) REST /api/* ▼ FastAPI (main.py · asyncio, single process) ├─ hub.py in-process pub/sub → WS fan-out ├─ agents.py 8 AI agents (status · task · confidence) ├─ brain.py LLM chain: Claude CLI → local LLM → templates ├─ llm_local.py Ollama / OpenAI-compatible client + model manager ├─ insights.py JARVIS Insights + executive briefings ├─ threats.py Threat Intelligence engine (risk · incidents · matrix) ├─ agenda.py Calendar + inbox + calendar intelligence ├─ google_sync.py Google Calendar OAuth + sync ├─ voice.py faster-whisper STT · wake phrases · intent router ├─ tts.py cross-platform speech (SAPI / say / espeak) ├─ services.py psutil telemetry + NewsAPI ├─ weather.py · connectivity.py · browser.py └─ routines.py APScheduler — agent rotation · syncs · alerts · briefings ``` 完整的详细信息以及向企业级技术栈（Next.js · Postgres · Redis · LangGraph）迁移的路径详见 [`ARCHITECTURE.md`](ARCHITECTURE.md)。 ## 🗺️ 路线图 - **阶段 1 — AI 指挥仪表盘** ✅ _（本仓库）_ - **阶段 2 — 多 Agent 智能** —— agent 之间的授权委托（LangGraph） - **阶段 3 — 计算机视觉运营** —— 多摄像头、区域监控 - **阶段 4 — 企业指挥平台** —— 多操作员、本地部署 AI、SSO - **阶段 5 — 自主决策支持** —— 提出 → 模拟 → 批准 → 执行 商业化方案详见 [`SAAS_PLAN.md`](SAAS_PLAN.md)。 ## 🔒 安全与隐私 - **本地优先。** 遥测、摄像头画面和语音均在**设备上**进行处理。摄像头状态检测基于运动 —— **不进行人脸识别或收集身份数据**。 - **仅限本地回环。** 服务器默认绑定 `127.0.0.1`。 - **敏感信息不进入 git** —— `.env`、`credentials.json`、`token.json` 和候补名单数据均已被 gitignored。 ## 📁 项目结构 ``` Avengers-Bobbiey-UCS/ ├─ main.py FastAPI app + all REST/WS endpoints ├─ agents.py · brain.py · llm_local.py · local_brain.py ├─ insights.py · threats.py · agenda.py · google_sync.py ├─ services.py · weather.py · connectivity.py · voice.py · tts.py · browser.py ├─ routines.py scheduler ├─ static/ the dashboard (index.html · app.js · style.css) ├─ site/ the public product/landing site ├─ start-jarvis.cmd Windows launcher ├─ start-jarvis.sh macOS / Linux launcher ├─ requirements.txt · .env.example └─ ARCHITECTURE.md · SAAS_PLAN.md ``` ## 👤 创始人 由 **Bobbiey** 端到端构建 —— 他是 Bobbiey UCS 的创始人、架构师和构建者 —— 来自印度海得拉巴。其使命是：重新定义人类与数据和 AI 交互的方式，从被动屏幕转向主动指挥系统。

标签：AI风险缓解, 后端开发, 数字孪生/指挥舱, 本地部署, 桌面应用, 计算机视觉, 语音控制, 逆向工具