Files

T

gx 12708618d4 docs: reference integrations + examples

- docs/integrations/frigate.md — полный production-tested guide:
  Dockerfile, docker-compose, config.yml, troubleshooting (s6+pid, scale_cuda,
  hwaccel issues), build steps
- docs/integrations/cctv-cpp.md — C++ pattern: IFrameSource interface +
  CuframesSource skeleton + CMake setup + runtime requirements
- examples/frigate-compose/ — reference compose stack (cuframes-pub + Frigate)
  с config.yml stub, .env.example, README
- examples/python-consumer/ — ctypes-based skeleton для AI/ML pipeline'ов
  (до v0.3 native pybind11 bindings)
- docs/integration.md — превратился в index-страницу, ссылается на specific guides

Reorganization упрощает onboarding: пользователь выбирает guide по типу
integration'а (Frigate/C++/Python/FFmpeg) и сразу видит реальный code.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-18 21:37:35 +01:00

2.5 KiB

Raw Blame History

examples/frigate-compose

Reference docker-compose для Frigate + cuframes integration. НЕ копировать в production бездумно — это шаблон, адаптируй под свою инфру (IP-адреса камер, пароли, mount paths, network).

Quickstart

Build patched Frigate image (single-time setup, ~15 мин):

# См. docs/integrations/frigate.md, Шаг 1 — там полный Dockerfile.
docker build -t local/frigate-cuframes:latest -f Dockerfile.frigate .

Pull cuframes publisher image:

docker pull git.goldix.org/gx/cuframes:0.1
# либо собрать local: docker build -t local/cuframes:0.1 -f docker/Dockerfile.runtime ../..

Скопировать .env:

cp .env.example .env
$EDITOR .env   # подставь свои camera passwords

Адаптировать docker-compose.yml:
- parking-cam-ip → реальный IP камеры
- --key cam-parking → имя по вкусу (должно matche'ить config.yml cuframes://<key>)
- cam-parking в Frigate config → так же matched
Адаптировать config/config.yml:
- детектор (cpu / onnx / tensorrt)
- пути к media
- дополнительные камеры если нужно

Run:

docker compose up -d
docker logs -f frigate
# UI: http://localhost:5000 (internal) либо https://localhost:8971 (auth)

Что демонстрирует

Один publisher (cuframes-pub-parking) делает 1× NVDEC на parking-камеру
Frigate подключается к publisher через ipc:container: + cuframes:// URL
Frigate не делает свой NVDEC для detect-path — берёт готовые NV12 frames

Что НЕ демонстрирует

Record path — Frigate всё ещё открывает второй RTSP к камере (для архива -c:v copy mux). v0.2 cuframes решит через encoded packet sharing (см. issue #2)
Multi-camera setup — добавь больше publisher'ов и camera-blocks в config.yml
HA/MQTT интеграция — добавь свой mqtt block

См. также

docs/integrations/frigate.md — полный walkthrough
docs/integration.md — общая интеграция

2.5 KiB Raw Blame History Unescape Escape