mcpField
O
openhue

openhue

github.com/nousresearch其他258.5k286 次安装今天更新
代码仓库

关于 openhue

openhue 是通过终端经 Hue Bridge 控制 Philips Hue 灯具和场景的命令行工具，适合管理家庭照明。它可按灯具、房间或区域查看和调整照明。

主要功能

  1. 01查看灯具、房间和场景
  2. 02控制灯具与房间开关
  3. 03调整亮度和色温
  4. 04按房间应用场景

适用场景

  1. 01调暗卧室灯光
  2. 02为办公室设置场景
  3. 03按计划调整照明

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nousresearch/hermes-agent --skill openhue

安装后在 Claude Code 中输入/openhue确认已加载。

详细介绍

OpenHue CLI

通过终端使用 Hue Bridge 控制 Philips Hue 灯具和场景。

前提条件

# Linux (pre-built binary — releases ship tarballs, not bare binaries)
curl -sL "https://github.com/openhue/openhue-cli/releases/latest/download/openhue_Linux_x86_64.tar.gz" \
  | tar -xz -C ~/.hermes/cache/scratch openhue \
  && install -m 0755 ~/.hermes/cache/scratch/openhue ~/.local/bin/openhue
# (use openhue_Linux_arm64.tar.gz on ARM64)

# macOS
brew install openhue/cli/openhue-cli

首次运行时，需要按下 Hue Bridge 上的按钮进行配对。Bridge 必须与设备处于同一本地网络。

适用场景

  • “打开／关闭灯具”
  • “调暗客厅的灯”
  • “设置场景”或“电影模式”
  • 控制指定的 Hue 房间、区域或单个灯泡
  • 调节亮度、颜色或色温

常用命令

列出资源
openhue get light       # List all lights
openhue get room        # List all rooms
openhue get scene       # List all scenes
控制灯具
# Turn on/off
openhue set light "Bedroom Lamp" --on
openhue set light "Bedroom Lamp" --off

# Brightness (0-100)
openhue set light "Bedroom Lamp" --on --brightness 50

# Color temperature (warm to cool: 153-500 mirek)
openhue set light "Bedroom Lamp" --on --temperature 300

# Color (by name or hex)
openhue set light "Bedroom Lamp" --on --color red
openhue set light "Bedroom Lamp" --on --rgb "#FF5500"
控制房间
# Turn off entire room
openhue set room "Bedroom" --off

# Set room brightness
openhue set room "Bedroom" --on --brightness 30
场景
openhue set scene "Relax" --room "Bedroom"
openhue set scene "Concentrate" --room "Office"

快速预设

# Bedtime (dim warm)
openhue set room "Bedroom" --on --brightness 20 --temperature 450

# Work mode (bright cool)
openhue set room "Office" --on --brightness 100 --temperature 250

# Movie mode (dim)
openhue set room "Living Room" --on --brightness 10

# Everything off
openhue set room "Bedroom" --off
openhue set room "Office" --off
openhue set room "Living Room" --off

备注

  • Bridge 必须与运行 Hermes 的设备处于同一本地网络
  • 首次运行时，需要亲自按下 Hue Bridge 上的按钮进行授权
  • 颜色仅适用于支持彩色的灯泡（不适用于仅支持白光的型号）
  • 灯具和房间名称区分大小写，可使用 openhue get light 检查准确名称
  • 搭配 cron 作业进行定时照明效果很好（例如，睡前调暗，醒来时调亮）

评论

支持 Markdown