Installation

Kacy — ready in 20 minutes

One command. The installer handles the rest — fully automatic, no expertise needed.

curl -O https://smarthomeblox.com/kacy-setup.sh && sudo bash kacy-setup.sh

Automatic Setup

What the installer does automatically

7 steps, fully automated — you are only asked for your credentials.

1

Download Kacy Brain from GitHub

Always fetches the latest version directly from the repository — up to date from the first run.

2

Set up Python environment (venv)

Creates an isolated virtual environment and installs all dependencies automatically — nothing pollutes your system Python.

3

Configure credentials

License key, API keys and Home Assistant URL — the installer prompts for everything in one go.

4

Set up alias list

Map device names to their entity IDs — the editor opens automatically so you can fill it in right away.

5

HTTPS certificate + nginx setup

Self-signed certificate and nginx reverse proxy configured automatically — secure out of the box, no manual SSL work.

6

Register & start systemd services

All services are registered, enabled and started immediately — Kacy is live before you close the terminal.

7

Set up auto-update cronjob

A daily cron job at 3:00 AM keeps Kacy up to date automatically — no manual SSH or update commands ever needed.

What you need to enter

Questions the installer asks

That is all. Everything else is set up automatically.

Installer Prompts — complete list
1 License key SMB-XXXXX-XXXX-XXXX
2 Anthropic API Key sk-ant-...
3 Home Assistant URL http://192.168.x.x:8123
4 HA Long-Lived Token Profile → Tokens → Create token
5 Alexa Media device optional
6–8 Telegram Bot Token, Chat ID, User ID optional — for crash alerts
9 Language de or en
10 Owner name e.g. Alex
11 Location e.g. Berlin, Germany
12 Timezone e.g. Europe/Berlin

Before you start

What should be ready beforehand

A short checklist before running the installer.

Raspberry Pi 4 or 5 with 64-bit OS Lite, SSH active
Home Assistant running and reachable on your local network
HA Long-Lived Access Token created in your profile
License key received from SmartHomeBlox
Anthropic API Key ready (included with Pro license)
Alias list prepared: device name → entity_id

Technician Quick Guide

The complete step-by-step reference for installing Kacy at a customer site — print-ready on a single page. Everything from pre-check to final verification.

Pre-install checklist All installer prompts Alias editor walkthrough HA integration steps Final verification Quick reference commands
Open Quick Guide & Print →