Skip to content
View keivanmalhani's full-sized avatar

Block or report keivanmalhani

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
keivanmalhani/README.md

Hi, I'm Keivan

I build local-first tools for photographers and filmmakers. 19 of them are here, they all run entirely on your own machine, and none of them ask for an account.

The through-line: taking a shoot from memory card to finished post without a subscription and without uploading a client's work to somebody else's cloud. Along the way that turned into an agent safety story, a deployment story, and a few workshop tools built the same way.

PHOTO
  shutter-roll ........... scanned film gets its real stock, camera and shoot date back
  shutter-cull ........... burst clustering, blur and eye scoring, keepers picked
       |
       v
  Lightroom Classic reads the XMP sidecars natively

AGENTS
  shutter-mcp ............ the same library, read-only, exposed to AI agents
  shutter-cull-mcp ....... the write side: agents propose, humans confirm, undo always

VIDEO
  shutter-select ......... local transcription, take detection, audio and image scoring
  shutter-clip ........... social re-rank, cut, phone-ready posts
       |
       +--> selects timeline, opens in Resolve or Premiere
       +--> analysis JSON, a versioned contract computed once

ON A SCHEDULE
  shutter-batch .......... the whole archive, nightly, in a container. Never twice.

WORKSHOP
  printcheck ............. drop an STL, see if it will print. Nothing uploads.
  filament-cost-tracker .. filament inventory and the true cost of a print, failures included
  camera-gear-pricing .... is this used lens actually a deal, measured against its own sold history
  shutter-warehouse ...... the other tools' output, aggregated three ways in Spark

BROWSER
  motion-recipes ......... fourteen micro-interactions with no animation library underneath
  portfolio-site ......... the site you are looking at, tested without a GPU
  exif-atlas ............. is a sample report, so you can see what this produces without installi
  gcode-lint ............. Static analysis for sliced 3D printer gcode. It reads the file once an
  goldenhour ............. A command line tool that tells a photographer when and where the light
  lutbox ................. Drop a photo and a `.cube` LUT onto the page. The grade is applied at 
  mcp-probe .............. Audit an MCP server before you connect an agent to it.
  timecode ............... SMPTE timecode arithmetic for video editors, with drop frame handled t

The tools

Project What it does Stack Suite
shutter-roll Scanned film comes home with no film stock, no camera, no ISO, and the scan date sitting... Python, exiftool, EXIF / XMP 31 tests
shutter-cull Point it at a shoot folder. It groups burst frames, scores every frame for blur... Python, OpenCV, ONNX Runtime 127 tests
shutter-mcp An MCP server that lets Claude and other agents inspect a photo library conversationally... Python, MCP SDK, FastMCP 21 tests
shutter-cull-mcp The write side of the agent story. An agent cannot call a write tool here: it has to... Python, MCP, agent safety 51 tests
shutter-select Culls raw footage. Transcribes every word locally with Whisper, finds takes by listening... Python, faster-whisper, PySceneDetect 97 tests
shutter-clip Zero-edit path from a footage drive to posted clips: motion-ranked picks with readable... Python stdlib, ffmpeg, HEVC / VideoToolbox 53 tests
shutter-batch Point a container at a media volume and the whole archive gets culled on a schedule... Python stdlib, Docker, Kubernetes 92 tests
printcheck Drag an STL onto the page. Overhang faces glow red, thin walls amber, open edges cyan... TypeScript, Three.js, Vite 28 tests
filament-cost-tracker What a 3D print actually costs, which is never just the filament: the failed prints that... Python stdlib, Klipper / Moonraker, OctoPrint 370 tests
camera-gear-pricing Used camera gear pricing from the official eBay APIs, never a scraper. It builds a... Python stdlib, OAuth2, eBay Browse API 220 tests
shutter-warehouse Batch analytics over the data the other shutter-* tools produce. A PySpark DataFrame ETL... Python, PySpark, Spark SQL 17 tests
motion-recipes Fourteen production-ready micro-interactions on the Web Animations API, each with a live... TypeScript, Web Animations API, Vite 103 tests
portfolio-site The public site itself: a portfolio with a WebGL hero where photographs cross-dissolve... TypeScript, WebGL2, GLSL 65 tests
exif-atlas is a sample report, so you can see what this produces without installing it. The library... Python 360 tests
gcode-lint Static analysis for sliced 3D printer gcode. It reads the file once and tells you what is... Python 258 tests
goldenhour A command line tool that tells a photographer when and where the light will be, at any... Python 217 tests
lutbox Drop a photo and a .cube LUT onto the page. The grade is applied at full resolution... TypeScript 253 tests
mcp-probe Audit an MCP server before you connect an agent to it. Python 221 tests
timecode SMPTE timecode arithmetic for video editors, with drop frame handled the way SMPTE ST... TypeScript 338 tests

2922 tests across 19 repositories, and that number is generated rather than written: collect.py builds a clean environment per repo, runs each real suite, and writes the counts to verified.json. The portfolio page and this README are rendered from that file and refuse to print a count that did not come from a run. It exists because a README once claimed nine tests that were not there, and that is the cheapest thing in the world for an interviewer to check.

How I build

  • Local-first is a feature, not a limitation. Client work should not have to cross a network to be useful. Every engine reads from disk, computes on the CPU in front of it, and writes back beside the originals.
  • Deployable and private are not opposites. shutter-batch runs the same engines nightly in a container, mounting your volume, on your cluster, with no outbound network.
  • Judgment beats thresholds. Scores are percentile-ranked within a run, so each shoot is judged against itself instead of against a constant that breaks on the next one.
  • Agents propose, humans confirm. The write-capable MCP server cannot be talked into a write: it needs a content-addressed plan token, an exact-phrase confirmation, and a staleness re-check at write time. Everything is undoable.
  • Composition over coupling. Tools call each other's CLIs and read versioned JSON rather than importing each other, so the expensive analysis runs once and either side can move.

Every repo is MIT and has CI.

Currently looking for customer-facing technical work where the job is turning a hard system into something a person can actually use.

Popular repositories Loading

  1. shutter-cull shutter-cull Public

    Runs a burst of near-identical shots through blur, eye and aesthetic scoring and writes the picks straight back as XMP, so Lightroom shows the culled set without ever touching your originals.

    Python 1

  2. shutter-select shutter-select Public

    Feeds raw footage through Whisper for the transcript, finds where one take ends and the next begins, scores each for quality, and hands back a selects timeline an NLE can actually open.

    Python

  3. camera-gear-pricing camera-gear-pricing Public

    Used camera gear price tracking from the official eBay APIs. Sold-price distributions per model, no scraping anywhere in the codebase

    Python

  4. motion-recipes motion-recipes Public

    Fourteen production-ready micro-interactions on the Web Animations API, with zero runtime dependencies

    TypeScript

  5. printcheck printcheck Public

    Drag an STL in and see the overhangs, the walls too thin to print clean, whether it fits your bed, and the orientation that avoids all three. Runs in the browser tab, never leaves it.

    TypeScript

  6. shutter-clip shutter-clip Public

    Points ffmpeg at a footage drive and comes back with the clips actually worth posting, ranked by motion instead of file order, packed for whichever platform you are posting to. Local, because a dri…

    Python