🏠 Aether
接入大模型的智能家居 AI 管家
用自然语言控制设备 · 视觉感知环境 · 定时自动化 · 语义知识图谱检索
English | 中文
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
接入大模型的智能家居 AI 管家
用自然语言控制设备 · 视觉感知环境 · 定时自动化 · 语义知识图谱检索
English | 中文
AI smart home assistant for Home Assistant: LangGraph agent + MCP tools + RAG knowledge graph + vision perception
Aether 的核心交互界面。输入自然语言即可控制家中设备——"把客厅灯关掉"、"空调调到 26 度",AI 会理解你的意图并执行操作。左侧聊天区域支持多轮对话,快捷斜杠命令帮你快速跳转到设备管理、定时任务等功能。
配置家庭名称、主人称呼、所在地区等信息。Aether 会根据这些信息提供更贴合你生活的服务。同时可以在这里切换深色/浅色主题,让界面随你喜好变化。
集中管理所有底层配置:天气 API 密钥、Exa 搜索引擎、摄像头视觉参数、Home Assistant 连接信息、助手角色设定。每个配置项以卡片形式呈现,点击即可弹出编辑面板。还支持 Emoji 索引重建和文档向量重建。
可视化管理所有 LLM 模型配置。分别设置对话模型、视觉模型和嵌入模型,支持切换不同供应商(OpenAI、Claude、DeepSeek 等)。每个账号可独立配置自己的 API Key,互不影响;另有一套全局 key(vision/embed 全局共享,chat/stt 可选全局兜底),用二级密码保护,忘记密码可一键重置。会话摘要自动复用对话模型,无需单独配置。
展示所有接入 Home Assistant 的智能设备及其实时状态。灯光的亮度色温、空调的温度模式、窗帘的开关进度——所有状态可视化呈现。也可以直接从面板操控设备,无需打开聊天。
用自然语言描述你想定时执行的事情,Aether 自动解析并生成 cron 表达式。"每天早上 7 点开窗帘"、"工作日晚上 10 点关掉所有灯"——说一句话就帮你建好定时任务,任务名也会自动生成。
创建基于条件的自动化规则:温度高于 30 度自动开空调、检测到运动时打开玄关灯。支持多条件组合和多重动作,让家真正"活"起来。规则纯文本条件评估时按创建者解析对应 LLM Key。
接入 RTSP 网络摄像头或 USB 摄像头,AI 实时分析画面内容。支持运动检测自动触发视觉推理,当画面出现异常时主动通知你。可以在聊天中直接询问摄像头"看到了什么"。
自定义每路摄像头视觉系统关注的对象和区域。在 /cameras 页的编辑弹窗里按摄像头分别配置,可以指定特定区域(如门口、窗户)或特定物体(如人、宠物、包裹)。只有关注项出现时才触发通知,避免无意义的频繁报警。
基于 RAG 技术构建的语义知识图谱。将文档和设备信息向量化后进行实体抽取和关系分析,生成可交互的 3D 图谱。通过 faiss 向量检索快速定位相关信息,支持一键重建索引。
AI 回复采用流式输出,逐字显示如同真人打字。支持 Markdown 格式渲染,代码块高亮,让对话既智能又美观。设备控制结果以结构化卡片呈现,操作结果一目了然。
verify_action 只读校验/report)┌─────────────┐ REST ┌─────────────────┐ MQTT ┌───────────┐
│ 浏览器 SPA │ ────────► │ Aether (8010) │ ◄──────► │ HA (8123)│
│ Vue 3 + Vite│ │ FastAPI+LLM │ └───────────┘
└─────────────┘ └────────┬────────┘ ▲
│ SQLite / faiss │ MQTT
▼ │
┌──────────────┐ ┌──────────────┐
│ app/data,logs│ │ Mosquitto │
└──────────────┘ │ (1884) │
└──────────────┘
一条 docker compose up 起全部四个服务(aether、aether-ha、mosquitto、aether-simulator)。前置准备:
# 1. 配置密钥
cp .env.example .env
# 编辑 .env,填入 LLM / STT 的 API Key
# 2. 复制配置模板
cp config.example.json config.json
# ha.token 留空即可,稍后在引导向导里填
# 3. (可选,建议)生成正式自签证书:不跑也能启动(容器自动生成临时证书兜底,
# 浏览器警告点「继续前往」即可);跑了则 SAN 覆盖本机 IP、无警告
bash scripts/gen_https_cert.sh
启动:
docker compose up -d --build # 首次或代码更新后加 --build
docker compose ps # 四个容器都 Up 即可(aether, aether-ha, mosquitto, aether-simulator)
打开 https://localhost:8010 进入应用(自签 HTTPS,浏览器警告与设备信任配置见 docs/tech/HTTPS部署指南.md),首次需走引导向导:
http://localhost:8123 完成账号注册并创建长期访问令牌注册需要安装码:首个注册用户自动成为管理员,为防新部署窗口期被局域网内他人抢注,首次注册要求填一枚安装码——容器首次启动时自动生成并打印到部署日志(
docker compose logs aether,搜「安装码」),也显示在http://localhost:8011/progress。之后给家人开通走管理员邀请码(运维中心 → 注册邀请码,签发后 24 小时未用自动过期):点「二维码」生成注册深链,家人手机扫码即落在注册页、码已填好;手机提示证书风险时按部署指南导入certs/rootCA.crt即可,详见docs/01-安装部署/Docker服务部署指南.md。
HA 首次初始化(新用户必读):
- 打开
http://localhost:8123→ 创建管理员账号(onboarding 流程,会要求填姓名/密码/位置)- 配置 MQTT 集成(让模拟器设备能上报到 HA):
脚本会自动创建指向 mosquitto 容器的 MQTT 集成(broker=docker exec aether-ha python /config/add_mqtt_config.py docker compose restart homeassistantmqtt、port=1884、user=aether)。也可在 HA UI 的「设置 → 设备与服务 → 添加集成 → MQTT」手动配置。- 登录 HA 后左下角头像 → 长期访问令牌 → 创建令牌 → 复制 JWT 粘贴到引导向导第 3 步
仓库不包含 HA 的运行时状态文件(onboarding/auth/entity_registry 等),每次 clone 都是干净的 HA,需走完上述 onboarding 才能使用。
ha_config/.storage/core.config保留默认地理位置/时区,ha_config/mqtt/*.yaml是模拟器设备声明,由 HA 启动时自动加载。
内置演示设备:仓库自带 11 个虚拟设备(3 灯 / 1 空调 / 1 窗帘 / 1 风扇 / 1 加湿器 / 2 传感器 / 2 插座),声明在
ha_config/mqtt/*.yaml,由aether-simulator容器通过 MQTT 上报状态。目的是让没有真实智能家居设备的用户也能立刻体验完整的 AI 控制流程(聊天开灯、调空调等)。接真实 HA 设备时如何处理演示设备:
- 方式一(推荐):在 HA UI「设置 → 设备与服务 → MQTT」里禁用对应实体,或直接删除
ha_config/mqtt/*.yaml后重启 HA 容器- 方式二:在
docker-compose.yml注释掉simulator服务和aether的depends_on: simulator,再docker compose up -d- 方式三:保留演示设备,Aether 会同时看到真实设备和演示设备,聊天时用设备名区分即可
docker compose logs -f aetherdocker compose down(数据保留在 Docker volume 和 logs/ 挂载目录)摄像头:默认走 RTSP 网络流(
vision.rtsp_url),容器无需特殊设备权限,只要摄像头 IP 在容器网络可达。若改用本地 USB 摄像头,需在aether服务加devices: ["/dev/video0:/dev/video0"](仅 Linux 主机)。
适合改代码时热重载。后端用 uvicorn,前端用 Vite 开发服务器:
# 后端依赖
python -m pip install -r requirements.txt
# 前端依赖
cd frontend && npm install
# 前端开发服务器(5173,代理 /api /ws 到 8010)
npm run dev
# 后端(项目根目录,另开终端)
python -m uvicorn app.main:app --host 0.0.0.0 --port 8010
# 前端构建并同步到后端静态目录(生产部署前)
npm run build
生产部署用 Docker:
docker compose up -d,然后浏览器访问https://localhost:8010。停止用docker compose down。
Aether 默认只在家里局域网用。想在外面用手机访问,不要做端口转发暴露公网,用 Tailscale(基于 WireGuard 的点对点 VPN)更安全——只有你自己 Tailscale 网络里的设备能连进来。
核心做法:
100.x.x.x 内网 IP0.0.0.0:8010(监听所有网卡),无需改启动命令100.64.0.0/10 访问 8010:New-NetFirewallRule -DisplayName "Aether Backend 8010 (Tailscale only)" `
-Direction Inbound -Action Allow -Protocol TCP -LocalPort 8010 `
-RemoteAddress 100.64.0.0/10 -Profile Any
https://<电脑的Tailscale IP>:8010/(用 tailscale ip -4 查电脑 IP)。首次访问会有自签证书警告,点「高级 → 继续前往」即可;导入 certs/rootCA.crt 后永久无警告(各设备步骤见 docs/tech/HTTPS部署指南.md)访问 8010,不是 5173:5173 是 Vite 开发服务器,只监听
127.0.0.1,外部设备连不上。8010 同时托管前端页面和 API,是日常使用和远程访问都该用的端口。
详细步骤、防火墙 profile 踩坑、故障排查见 docs/01-安装部署/Tailscale远程访问与防火墙配置.md。后端 CORS 已预放行 Tailscale 100.64.0.0/10 网段(app/main.py 的 allow_origin_regex)。
环境变量优先级最高,可覆盖 config.json:
LLM 密钥推荐用「模型」页管理(
/models:per-user 密钥 + 角色绑定 + 全局配置二级密码),会自动写入.env并持久化到数据库。「高级」页也有一个 API Keys 段可增删 per-user key。
app/
├── main.py # FastAPI 入口:生命周期、中间件、路由注册、SPA 托管
├── bootstrap.py # 服务初始化(构造所有服务实例)
├── container.py # DI 容器(AppContainer,消除 from main import 全局)
├── core/ # 配置、数据库、鉴权、限流、异常、链路追踪
├── clients/ # HA / LLM(chat/vision/embed)HTTP 客户端
├── services/ # 业务服务(规则、调度、视觉、天气、会话、RAG、语义图…)
├── agents/ # LangGraph Agent、Dispatcher、Validator
├── mcp/ # MCP 工具(本地工具、外部 Server、工具执行器)
├── routes/ # REST/WS 路由(按功能分模块)
├── sg/ # 语义图 pipeline(实体抽取、向量化、关系分析、构图)
├── schema/ # 请求/响应 Schema
└── data/ # SQLite 库、JWT 密钥、emoji 向量索引(运行时生成)
frontend/ # Vue 3 + Vite 前端
ha_config/ # Home Assistant 配置(挂载到 HA 容器 /config;只跟踪配置模板,运行时状态由 HA 生成)
mosquitto/ # Mosquitto MQTT 配置
tests/ # 后端 pytest(1300+ 测试)
frontend/tests/ # 前端 vitest
docs/ # 用户层 + 技术层文档(按功能分类)
# 后端
pytest # 默认跳过 slow 标记(见 pytest.ini)
pytest -m slow # 显式运行慢测试(真实拉起插件子进程/RPC e2e,约 3 分钟)
pytest tests/test_dispatcher.py # 单个模块
# 前端
cd frontend && npm test
CI 通过 GitHub Actions 在每次 push 和 pull request 时自动运行 pytest(默认即 not slow)。
详细文档在 docs/ 下,按功能分类:
docs/01-安装部署/ —— 环境准备、Docker 部署、HA 连接、LLM 密钥、天气 API、Tailscale 远程、本地 Ollamadocs/02-AI聊天/ —— 聊天入门、人格自定义、模型角色、会话管理、斜杠命令docs/03-设备控制/ —— 自然语言控制、设备控件、设备面板、场景模式、设备语义映射、AI 设备操作权限docs/04-自动化规则/ —— 定时任务、自动化规则、规则维护、视觉触发docs/05-摄像头视觉/ —— 摄像头接入(含离线行为)、关注项配置、运动检测docs/06-集成扩展/ —— Exa 搜索、MQTT 接入、外部 MCP、模型家族适配插件docs/07-个性化/ —— Emoji 自定义、家庭信息与主题docs/08-运维排查/ —— API 鉴权、日志排查、健康检查、离线告警与家庭周报、运维中心docs/09-商业化工程化清单.md —— 交付能力盘点与实施记录docs/10-交付物料/ —— SLA 模板、免责声明模板docs/tech/ —— 架构概述、API/MCP 参考、调度/自动化引擎、视觉子系统、数据流向、配置参考侧边栏四个入口,其余功能通过斜杠命令到达:
常用斜杠命令(共 17 个,聊天框打 / 查看全部):
欢迎提交 Issue 和 PR。如果你也想出现在贡献者列表里,提个 PR 即可——GitHub 会根据 commit 邮箱自动识别。
MIT © 2026 Aether
本项目涉及摄像头画面分析与家庭设备控制,部署与使用风险请参阅
docs/10-交付物料/免责声明模板.md。
Built with ❤️ by Aether
AI smart home assistant for Home Assistant: LangGraph agent + MCP tools + RAG knowledge graph + vision perception
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Fantasy stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। AI smart home assistant for Home Assistant: LangGraph agent + MCP tools + RAG knowledge graph + vision perception