Is Kino still maintained?

Yes, active. Last change 17 days ago.

New, little track record. 4 stars, 1 months old. Look at the code and the owner before running it.

How to install on macOS

t0mer/Kino

Self-hosted service that watches WhatsApp group photos through OpenWA, finds your kids' faces locally on CPU, and saves and forwards their photos, with a web UI to teach it each face

Python#docker#face-detection#face-recognition#family-photos

Before you start

Is it free?: YesOpen source (Apache-2.0).
Still maintained?: Yes, activeLast change 17 days ago.
Can I trust it?: New, little track record4 stars, 1 months old. Look at the code and the owner before running it.

Difficulty: Moderate
Time: about 15 min
Stars: ★ 4
Activity: Updated this month

Saved setup from 1 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Heads-upBuilding it yourself? It also needs 24 settings in .env (1 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Docker

docker compose up -d

Docker

docker run techblog/kino version

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 7 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Python >=3.12runtime
1×Docker tool
1×pip package manager

24× settings in .env

KINO_DATA_DIR
KINO_PHOTOS_DIR
KINO_OPENWA_API_KEYsecretoptional
KINO_OPENWA_SESSION_IDoptional
KINO_WEBHOOK_SECRETsecretoptional
KINO_ADMIN_USER
KINO_ADMIN_PASSWORD_HASHsecret
KINO_METRICS_PUBLIC
KINO_EMBEDDER
KINO_DET_SIZE
KINO_TILING
KINO_TILE_GRID
KINO_TILE_OVERLAP
KINO_WORKERS
KINO_ORT_THREADS
KINO_STRIP_GPS
KINO_TIMEZONE
KINO_RAW_RETENTION_DAYS
KINO_FACE_RETENTION_DAYS
KINO_BURST_ENABLED
KINO_DIGEST_CRON
KINO_APPRISE_URLS
KINO_LOG_LEVEL
KINO_LOG_JSON

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/t0mer/Kino/badge.svg)](https://gitmanual.com/t0mer/Kino)

Good to know

Dockerfile available (base image: node:22-alpine).
Nested projects: demo/requirements.txt, web/package.json

Details

License: Apache-2.0
Open issues: 0
Branch: main

Files we read (7)

.env.example

.github/workflows/ci.yml

.github/workflows/docker-image.yml

Dockerfile

README.md

docker-compose.yml

pyproject.toml

366 files in the repo

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like Kino that run on macOS