Ignis Core
Self-hosted сервер для управления умными лампами WiZ по локальной сети. FastAPI бэкенд с веб-интерфейсом, планировщиком расписаний и REST API для мобильного приложения.
Возможности
- Discovery -- автоматическое обнаружение ламп WiZ в локальной сети (UDP broadcast). Поддержка нескольких подсетей через
SCAN_NETWORK. - Группы -- объединение ламп в именованные группы (спальня, кухня, ...). Хранение в SQLite.
- Управление -- включение/выключение, яркость, цветовая температура, RGB-цвет, 35+ встроенных сцен.
- Расписания -- одноразовые таймеры и cron-задачи через APScheduler с персистентным хранилищем.
- Веб-интерфейс -- SPA на Vue 3 + Tailwind, встроен в сервер как статика.
- API -- REST API с авторизацией по API-ключу для мобильных клиентов.
Быстрый старт
# Клонировать
git clone https://git.akokos.ru/artem.kokos/ignis-core.git
cd ignis-core
# Виртуальное окружение
python3 -m venv .venv
source .venv/bin/activate
# Зависимости
pip install -r requirements.txt
# Конфигурация
cp .env.example .env
# Отредактировать .env -- указать API-ключ и таймзону
# Запуск
uvicorn main:app --host 0.0.0.0 --port 8000
Сервер будет доступен на http://<ip>:8000. Веб-интерфейс -- на корневом URL.
Конфигурация (.env)
# API-ключ для авторизации (если не задан -- авторизация отключена)
IGNIS_API_KEY=your-secret-key
# Таймзона для расписаний (по умолчанию Asia/Novosibirsk)
APP_TIMEZONE=Asia/Almaty
# Подсети для сканирования (через запятую, по умолчанию -- автоопределение)
SCAN_NETWORK=192.168.1.0/24
# Уровень логирования
LOG_LEVEL=INFO
Структура проекта
ignis-core/
├── main.py -- точка входа FastAPI, lifespan
├── requirements.txt -- зависимости
├── .env -- конфигурация (не в git)
├── static/
│ └── index.html -- веб-интерфейс (Vue 3 SPA)
├── app/
│ ├── core/
│ │ ├── database.py -- async SQLAlchemy, SQLite
│ │ ├── discovery.py -- UDP-сканирование сети WiZ
│ │ ├── scheduler.py -- APScheduler + jobstore
│ │ └── state.py -- in-memory состояние (устройства, группы)
│ ├── models/
│ │ ├── device.py -- модели Device, Group (SQLAlchemy + Pydantic)
│ │ └── schedule.py -- модель ScheduleTask
│ ├── drivers/
│ │ └── wiz.py -- UDP-драйвер протокола WiZ
│ └── api/
│ ├── deps.py -- авторизация (X-API-Key)
│ └── routes/
│ ├── devices.py -- CRUD устройств и групп
│ ├── control.py -- управление лампами
│ └── schedules.py -- расписания (once, cron)
└── ignis.db -- SQLite база (создаётся автоматически)
API
Авторизация: заголовок X-API-Key.
Устройства и группы
| Метод | Путь | Описание |
|---|---|---|
| GET | /devices |
Все обнаруженные лампы |
| GET | /devices/groups |
Все группы |
| GET | /devices/scenes |
Доступные сцены WiZ |
| POST | /devices/groups |
Создать группу |
| DELETE | /devices/groups/{id} |
Удалить группу |
| POST | /devices/rescan |
Пересканировать сеть |
Создание группы (JSON body):
{"id": "bedroom", "name": "Спальня", "macs": ["a8bb50aabbcc", "a8bb50ddeeff"]}
Управление
| Метод | Путь | Описание |
|---|---|---|
| POST | /control/device/{id} |
Управление лампой |
| POST | /control/group/{id} |
Управление группой |
| POST | /control/device/{id}/blink |
Мигнуть лампой |
| GET | /control/device/{id}/status |
Статус лампы |
| GET | /control/group/{id}/status |
Статус группы |
Query-параметры управления: state (bool), brightness (int, 10--100), temp (int, 2700--6500), scene (string), r/g/b (int, 0--255).
Расписания
| Метод | Путь | Описание |
|---|---|---|
| POST | /schedules/once |
Одноразовый таймер |
| POST | /schedules/cron |
Повторяющаяся задача |
| GET | /schedules/tasks |
Все активные задачи |
| DELETE | /schedules/{job_id} |
Отменить задачу |
Стек
- FastAPI -- async HTTP-сервер
- SQLAlchemy 2.0 -- async ORM, SQLite через aiosqlite
- APScheduler -- планировщик с персистентным хранилищем
- WiZ Protocol -- UDP-управление лампами (порт 38899)
- Vue 3 + Tailwind -- встроенный веб-интерфейс
Клиенты
- Веб-интерфейс -- встроен в сервер (
static/index.html) - Ignis App -- мобильное приложение (Flutter)
Лицензия
Частный проект.