zzstoatzz.io
this repo has no description
add deployment instructions
+29
-4
README.md
+29
-4
README.md
···
4
4
5
5
automatically adjusts lights based on sun position. provides entry points for external systems (geofencing, bedtime routines, etc.) to override behavior.
6
6
7
-
## install
7
+
## deploy
8
8
9
9
```bash
10
-
uv add solux
10
+
# install uv
11
+
curl -LsSf https://astral.sh/uv/install.sh | sh
12
+
13
+
# clone
14
+
git clone https://tangled.org/zzstoatzz.io/solux
15
+
cd solux
16
+
17
+
# set your hue bridge credentials
18
+
export HUE_BRIDGE_IP=192.168.0.165
19
+
export HUE_BRIDGE_USERNAME=your-username-here
20
+
21
+
# test it works
22
+
uv run solux status
23
+
24
+
# connect to prefect cloud (one-time)
25
+
uv run prefect cloud login
26
+
27
+
# deploy and start worker
28
+
uv run prefect deploy --all
29
+
uv run prefect worker start --pool default
11
30
```
12
31
13
-
requires `HUE_BRIDGE_IP` and `HUE_BRIDGE_USERNAME` environment variables.
32
+
the worker pulls from git and runs every 15 minutes. to run as a service, use systemd or similar.
14
33
15
34
## cli
16
35
17
36
```bash
18
37
solux # run once - apply current circadian state
19
-
solux run -d # run as daemon (updates every 15m)
20
38
solux status # show current mode and light state
21
39
solux schedule # show today's lighting phases
22
40
···
81
99
- **golden_hour** → **sunset** → **dusk** → **evening** → **night**
82
100
83
101
the controller interpolates smoothly between phases.
102
+
103
+
## configuration
104
+
105
+
| env var | description |
106
+
|---------|-------------|
107
+
| `HUE_BRIDGE_IP` | ip address of your hue bridge |
108
+
| `HUE_BRIDGE_USERNAME` | hue api username ([how to get one](https://developers.meethue.com/develop/get-started-2/)) |