[Important] No one would want to use this code as is. This is very hard-coded to suite just own my needs.

home-cli

Flask server for smart home control, exposed to HomeKit via Homebridge, with natural language control via Claude tool calling and cron-based scheduling.

Devices:

• Edison bulbs
• Philips Hue lights
• Curtains
• Air conditioner

graph TD
    subgraph User [User]
        iPhone[iPhone 📱]
        HomePod[HomePod 🔊]
        Shortcut[Siri Shortcut / dictation]
    end

    subgraph Pi [Raspberry Pi]
        subgraph Docker [Docker Compose]
            subgraph HBContainer [homebridge container]
                HB[Homebridge :51827]
                Plugin[http-switch / web-thermostat plugins]
                HB --- Plugin
            end

            subgraph FlaskContainer [flask container]
                Flask[Flask :5001]
                ServerPkg[server package]
                Flask --- ServerPkg
            end
        end

        State[flask-data volume]
        Secrets[secrets.json]

        Plugin -->|HTTP POST| Flask
        FlaskContainer -->|read/write| State
        FlaskContainer -->|read-only| Secrets
    end

    subgraph Devices
        SB[SwitchBot Cloud API]
        IRHub[SwitchBot IR Hub]
        Hue[Hue Bridge]
        Globe[Globe 🌏]
        Edison[Edison Lights 💡]
        Curtain[Curtains 🪟]
        AC[Air Conditioner ❄️]
        HueLights[Hue Lights 💡]

        SB --> Globe
        SB --> Curtain
        SB --> IRHub
        IRHub --> Edison
        IRHub --> AC
        Hue --> HueLights
    end

    Anthropic[Anthropic API]

    iPhone -->|HomeKit mDNS| HB
    HomePod -->|HomeKit mDNS| HB
    Shortcut -->|HTTP POST + prompt| Flask
    ServerPkg <-->|HTTPS| Anthropic
    ServerPkg -->|HTTPS| SB
    ServerPkg -->|HTTP| Hue

Loading

Requirements

• Docker

Setup

Copy secrets to the project root:

// secrets.json
{
    "token": "YOUR_SWITCHBOT_TOKEN",
    "secret": "YOUR_SWITCHBOT_SECRET",
    "hue_bridge_ip": "YOUR_BRIDGE_IP",
    "hue_username": "YOUR_HUE_USERNAME",
    "anthropic_api_key": "YOUR_ANTHROPIC_API_KEY"
}

Install git hooks:

./setup.sh

Running

docker compose up -d --build

The Flask server runs on port 5001. Homebridge runs on port 51827.

Pairing with HomeKit

Open the Home app, tap + > Add Accessory, and enter pin 031-45-154.

API

Method	Endpoint	Description
GET	/status	Current state of all devices
GET	/switchbot/devices	List all SwitchBot devices
POST	/switchbot/globe/<on|off>	Globe light
POST	/switchbot/edison/<on|off>	Edison lights
POST	/switchbot/curtain/<open|close>	Curtains
GET	/switchbot/ac/status	AC state
GET	/switchbot/ac/targetTemperature?value=FLOAT	Set AC temperature
GET	/switchbot/ac/targetHeatingCoolingState?value=INT	Set AC mode (0=off, 1=heat, 2=cool, 3=auto)
POST	/hue/on	Hue lights on
POST	/hue/off	Hue lights off
POST	/preset/<name>	Apply a preset from config/presets.json
POST	/presence/enter	Triggered by GPS arrival or motion detected — restores state from last snapshot
POST	/presence/leave	Triggered by GPS departure — saves snapshot and turns off all lights
POST	/llm	Natural language command via {"prompt": "..."} — routed through Claude