AI SummaryThis file is the single source of truth for how an AI assistant should work on this codebase. Read it first, every session, before touching any file. The generic Pinokio scaffolding starts at "## Generic Pinokio
Install
Copy this and paste it into Claude Code, Cursor, or any AI assistant:
I want to add the "phosphene — Cursor Rules" prompt rules to my project. Repository: https://github.com/mrbizarro/phosphene Please read the repo to find the rules/prompt file, then: 1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type) 2. If there's an existing rules file, merge the new rules in rather than overwriting 3. Confirm what was added
Description
Local generative video panel for Apple Silicon. Wraps LTX-2 MLX, joint audio+video, one-click Pinokio install.
Phosphene — agent operating manual
This file is the single source of truth for how an AI assistant should work on this codebase. Read it first, every session, before touching any file. The generic Pinokio scaffolding starts at "## Generic Pinokio Development Guide" further down — that's the upstream template. This top section overrides it where they conflict. ---
1. What Phosphene is
A free desktop panel that wraps Lightricks' LTX 2.3 model running natively on Apple's MLX framework, exposed as a one-click install through Pinokio. Generates video and audio jointly in a single forward pass on Apple Silicon Macs. Apple-Silicon-only. Public artifacts: • GitHub: github.com/mrbizarro/phosphene (public, MIT for the panel) • Pinokio Discover: searchable as "Phosphene" • Twitter handle: @AIBizarrothe The panel itself is MIT. Model weights have Lightricks' own license.
2. Where to work
The Pinokio install dir IS the canonical workspace. There is no separate dev folder. Old "local dev" copy was deleted to consolidate. ` ~/pinokio/api/phosphene.git/ ← edit here ├── .git/ ← real working copy of mrbizarro/phosphene ├── ltx-2-mlx/ ← upstream package, cloned at install │ ├── env/ ← Python 3.11 venv │ └── packages/{ltx-core-mlx,ltx-pipelines-mlx} ├── mlx_models/ ← downloaded weights │ ├── ltx-2.3-mlx-q4/ ← Q4 base (~25 GB) │ ├── ltx-2.3-mlx-q8/ ← optional Q8 (~25 GB) │ └── gemma-3-12b-it-4bit/ ← text encoder (~7.5 GB) ├── mlx_outputs/ ← generated mp4s ├── panel_uploads/ ← user-uploaded reference images ├── assets/ ← logos, banner, hero clip ├── launch/ ← launch post drafts (X, Reddit, Pinokio, CivitAI) ├── mlx_ltx_panel.py ← MAIN: HTTP server, HTML UI, queue ├── mlx_warm_helper.py ← subprocess holding MLX pipelines warm ├── pinokio.js / install.js / start.js / update.js / reset.js / download_q8.js ├── patch_ltx_codec.py ← applies patches to upstream package └── required_files.json ← single source of truth for "installed" ` To work: cd ~/pinokio/api/phosphene.git/, edit, git commit, git push. Pinokio's Update button does git pull here. No separate copy to keep in sync.
3. Architecture (request → frame)
` Pinokio app (port 42000) └── proxies to → mlx_ltx_panel.py (port 8198) │ ├── serves a single-page HTML/JS UI from one Python process ├── exposes HTTP API: /run, /status, /upload, /helper/restart, ... ├── owns a job queue (FIFO) + worker thread └── speaks JSON-over-stdin/stdout to: │ └── mlx_warm_helper.py (subprocess in same venv) ├── holds MLX pipeline objects warm across jobs ├── pipeline classes from ltx-2-mlx package ├── reaps itself after LTX_IDLE_TIMEOUT (1800s default) ├── emits events: log / done / error / exit └── on death → panel sees stdout EOF ` Both processes run inside ltx-2-mlx/env (the Python 3.11 venv). Helper restarts cheaply via POST /helper/restart to pick up code changes without restarting the panel.
Discussion
Health Signals
My Fox Den
Community Rating
Sign in to rate this booster
Works With
Any AI assistant that accepts custom rules or system prompts