Skip to content
Projects

Gianluca-Improta/cinekive has 111 GitHub stars and 1 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and -1 in 15 days. Last checked 2026-11-15 15:58 UTC. Last push 2026-10-20.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
0
in 15 days
-1
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Local-first cinematic still archive for filmmakers. Search your frames by look, mood, technique or director with SigLIP semantic search; ingest video and URLs; build moodboards. Free desktop app for Win/Mac/Linux, Pro unlocks studio tools. Your library stays on your disk.

Self-hosted

README.md

Original

Cinekive

Your cinematic archive. Local. Searchable. Yours.

Drop a film, a stills folder, or a URL. Cinekive finds the heroes, tags the craft, and lets you pull the frame you meant — by look, director, technique, or mood — without scrubbing a timeline or renting someone else's library.

Inspired by FilmGrab, EyeCandy, Flim & Kive. Built to live on your machine.

中文说明 → README.zh-CN.md

Cinematic still Archive still Archive still

Release License Stack Local Discussions

Downloads · Watch · Quick start · Who it’s for · Tour · FAQ · vs FilmGrab / Flim / Kive · Changelog · Roadmap · Join in · 中文


Who it’s for

  • Editors & directors building lookbooks without scrubbing a full timeline
  • Commercial / social teams who need client-safe references on a studio drive
  • Cinephiles & students collecting stills they have rights to access
  • Anyone who wants a local FilmGrab-style archive plus ingest and moodboards

New here? Start with the FAQ or skim Cinekive vs other tools.

If this saves you time, a GitHub star helps others find it.


Downloads

→ Download Cinekive v0.5.3 — no Docker or terminal needed on Windows / Mac.

Your computer Download this Then
Windows Cinekive-0.5.3-win-x64.exe Double-click → Start menu shortcut appears
Windows (no install) Cinekive-0.5.3-portable.exe Double-click and run
Mac (Apple Silicon M1/M2/M3/M4) Cinekive-0.5.3-mac-arm64.dmg Open DMG → drag to Applications
Mac (Intel) Cinekive-0.5.3-mac-x64.dmg Open DMG → drag to Applications
Linux .AppImage / .deb Needs Docker Desktop for now

Free vs Pro

Same installer, and the same code you see in this repo. Pro is a one-time Gumroad license ($19, early-bird $12).

Free is the default everywhere — installers, docker compose, and builds from source alike. Pro unlocks with a real license: a Gumroad key or a signed 14-day trial key. There is no environment variable that flips Pro on.

Free (Community) Pro ($19 once)
Promise Your local cinematic archive Studio workflow unlocked
Search + ingest Yes Yes
Single-shot export Yes Yes
LAN phone URL Yes Yes
Projects Soft cap (3) Unlimited
Archive mirror sync Browse only Sync tools
Continuous craft enrich Manual only Always-on drip
Cloud VLM (OpenRouter / ChatGPT / Claude / Kimi) Local Ollama only Bring your own key
Batch export / share tunnel — Yes
Board PNG/PDF export — Yes
Moodboard canvas — Yes
Lookbook layout templates — Yes
Generate still from reference (BYO image key) — Yes
Folder watcher (auto-ingest) Manual drop Yes
Agent / inspiration seek — Yes
Global dedupe — Yes
MCP server for external agents — Yes
Promo / upgrade links Small Settings / Sidebar Removed
Support GitHub Issues / Discussions Email (~48h)

Activate in Settings → Cinekive Pro. Seller notes: docs/GUMROAD.md.

Testing Pro? Signed 14-day trial keys unlock everything, then drop back to Free. Expiry is an absolute timestamp checked against network time, so winding the system clock back does not extend it. Ask for a key at [email protected].

Gating is client-side by nature — this is MIT source, and anyone can patch their own copy. The point is that a plain clone-and-build gives you Free, so Pro is a deliberate choice rather than an accident. If you rely on Cinekive at work, buying a license is what keeps the free edition moving.

Install in 3 steps

  1. Download the file for your OS (links above)
  2. Open Cinekive → pick a folder for your stills → click Start Cinekive
  3. Wait while the native engine downloads once (~550 MB). Next launches are instant.

That’s it. No Docker. No terminal. No npm / docker compose.

macOS Gatekeeper: right-click the app → Open the first time (unsigned build).
Windows SmartScreen: click More info → Run anyway if prompted.
Linux AppImage: chmod +x Cinekive-*.AppImage && ./Cinekive-*.AppImage (Docker still required).

Phone on WiFi: Settings shows a LAN URL — open it on your phone while Cinekive runs on your computer (same network).

A fully offline installer (engine baked in) is on the roadmap.

Prefer the browser?

.\scripts\bootstrap.ps1   # Windows
./scripts/bootstrap.sh    # macOS / Linux

Then open http://localhost:3000


Watch

Watch Cinekive on YouTube

Cinekive walkthrough — watch on YouTube


Screenshots

FilmGrab archive grid

Browse your archive — heroes, craft filters, FilmGrab / ShotDeck / your own ingest

Discovery grid

Discovery — find frames by look, technique, mood

Moodboard canvas

Moodboard — drag project clips, stickies, text, stacks, named concepts

Commercials project

Own footage — commercials / narrative / social shelves

Archives UI

Archives — mirrors, logins, more sources

Sample archive frames reel

Sample frames (your library stays private — nothing under data/ is in git)


Why it exists

The old way With Cinekive
Bookmark FilmGrab forever Own the frames on disk
Scrub Resolve for “that neon night” Type it. SigLIP + craft filters.
Brief in a Google Doc the AI never sees Brief lives on the project
yt-dlp in one terminal, ingest in another Paste URL → download → ingest
Moodboards scattered across tools Per-project canvas: stacks, concepts, notes, audio

What you get (v0.5.3)

New in 0.5.3 — see CHANGELOG.md:

  • Semantic search actually works again — a filter mismatch had been silently downgrading every visual query to filename matching; scores are now calibrated so a strong look match outranks an incidental title hit
  • Free by default everywhere — source builds no longer unlock Pro; Pro needs a real Gumroad or signed trial license
  • 14-day trial keys for testers, with absolute expiry and clock-rollback checks
  • Offline archive previews — 12 public-domain film stills bundled, so Seed cards render with no network
  • Spacebar play + hover autoplay on stills; delete button on empty projects

Also in the 0.5.x line:

  • Cloud VLM (Pro) — OpenRouter, ChatGPT/OpenAI, Claude (via OpenRouter), Kimi; local Ollama stays free

  • Board PNG/PDF export (Pro) + folder watcher auto-ingest

  • Cinekive Pro open-core — $19 one-time Gumroad license; Free stays useful

  • Native engine — relocatable Python in the engine pack

  • One-click desktop install — Windows .exe / Mac .dmg; native engine by default (no Docker or terminal)

  • Phone on same WiFi — browse your library from a phone browser on your LAN

  • Faster craft enrich — continuous VLM drip with live Activity status; quicker Ollama calls

  • One-click downloads — hero frames and GIF/loop previews save in-place (no tab navigation)

  • Local AI — SigLIP + yt-dlp bundled in the engine; Ollama auto-detected for craft tags (optional install)

  • GHCR pre-built images — Docker users pull images instead of building locally when possible

  • Narrative / Commercial / Social — ingest your own footage (drop files or any yt-dlp URL)

  • Archives — FilmGrab, EyeCandy, ShotDeck, MovieStillsDB, StillsLab mirrors + Discover list

  • Search — film titles, directors, techniques, eras, visual look (SigLIP + metadata routing)

  • Languages — UI in EN / 中文 / ES / FR / DE / JA; Chinese craft taxonomy labels

  • Inspector + full panel — side inspector by default; click the image for a large stage

  • Moodboards — infinite canvas, project clip rail (drag in), text, stickies, audio/media URLs, named concepts, stacks

  • Desktop or browser — Windows / Mac / Linux app, or web at :3000

  • Local-first — no cloud account; optional temporary share link via tunnel

  • Transparent rights badges on every still (subscription ref / study / generated / cleared)

  • Craft graph chips — jump archive along lighting, technique, film, director from any still

  • Approved brief package (Pro) — moodboard → client PDF + markdown handoff

  • Public marketing site under landing/

Help & compare: FAQ · vs other tools · Support


Quick start

Easiest: bootstrap (browser)

git clone https://github.com/Gianluca-Improta/cinekive.git
cd cinekive
.\scripts\bootstrap.ps1
git clone https://github.com/Gianluca-Improta/cinekive.git
cd cinekive
./scripts/bootstrap.sh

Open http://localhost:3000 — needs Docker Desktop running. First search may download SigLIP (~800 MB).

Desktop app

  1. Install Docker Desktop and start it
  2. Download from Releases or build:
.\scripts\desktop.ps1 -Dist        # → apps/desktop/release/
cd apps/desktop && npm run dist:mac     # macOS
cd apps/desktop && npm run dist:linux   # Linux

First launch: wizard → pick archive folder → Start. Guide: docs/DESKTOP.md.

Your media is never in the repo. data/ is gitignored. Point LIBRARY_HOST_PATH at any drive.

Packaging / no-Docker plans: docs/PACKAGING.md · Full guide: docs/GUIDE.md · Agent API: docs/AGENT_API.md · MCP: docs/MCP.md


Tour

First open shows a short onboarding. Re-run anytime from the top bar Tour.

Step What
Shelves Narrative / Commercial / Social vs Archives
Ingest Full-screen drop zone + URL paste
Archives Mirrors (with logins) + More sources
Moodboard Project → Moodboard → drag from clip rail or Send to board
Inspector Default side panel; click image / double-click for full stage

Stack

Layer Tech
UI Next.js 15
API FastAPI (cinearchive package)
Vectors Qdrant + SigLIP
Enrichment Optional local VLM (Ollama)
Desktop Electron + Docker Compose
Data SQLite + files on disk
┌─────────────┐     ┌──────────────┐     ┌─────────┐
│  Web / App  │────▶│  FastAPI     │────▶│  Qdrant │
│  :3000      │     │  :8000       │     │  :6333  │
└─────────────┘     └──────┬───────┘     └─────────┘
                           │
                    data/library · artifacts · db

Roadmap / v2

Ideas on the table — comment, upvote, and PR. Nothing here is locked.

Likely v2

  • Linux native engine pack
  • Pre-built GHCR images (shipped v0.4 — faster first Docker launch)
  • Richer canvas: resize frames, video preview loops on the board, PDF/ref cards
  • Brief → board: pitch text → ranked shots auto-laid on a moodboard
  • Better archive sync UX (resume, progress, selective film ingest)
  • One-click shareable static HTML gallery export
  • Signed desktop builds + auto-update
  • Deeper craft graph (shape / genre / lighting links across the library)
  • Multi-user / team library on a shared GPU box (still self-hosted)

Wildcards (tell us if you want these)

  • Resolve / Premiere panel plugins
  • Mobile companion for on-set stills
  • Federated “public shelf” of your cleared stills (opt-in only)
  • Framechain bridge: send a board concept → framechain.ai AI video draft

Full living list: docs/ROADMAP.md · discuss in GitHub Discussions.


Join in

This is an open, local-first tool for filmmakers and editors. You are invited.

Channel Use it for
Discussions Ideas, Q&A, show your board (preferred)
Issues Bugs and concrete tasks
Contributing Small focused PRs
Roadmap What’s next — comment and upvote

Starter threads:

Respect copyright: mirror scripts are for your licensed access; we do not ship anyone else’s stills in the repo.

Code of conduct: CODE_OF_CONDUCT.md · Security: SECURITY.md · Support: SUPPORT.md


Creator & support

Built by Gianluca Improta.

Link For
Cinekive Pro on Gumroad $19 one-time — mirrors, batch export, tunnel, continuous enrich
framechain.ai Cheap canvas AI video generation
gianlucaimprota.com Director / maker portfolio
gemimedia.cn Video production
GitHub Sponsors Donations — keeps the free edition moving

Pro buyers: activate in Settings → Cinekive Pro. Support: [email protected].

Free builds may show creator links in Settings / Sidebar; Pro removes them.


License

MIT — use it, fork it, keep your library private.

Copyright (c) 2026 Cinekive contributors