# drowzeys/imagination-studio-by-keys-wasserman

> imagination-studio-by-keys-wasserman is a local film studio for planning a film, generating its pictures, video, voices and music, and then editing and exporting it. Its core idea is that planning and every render run inside one Studio application on the user's own machine, with models that depend on the hardware and installed components. Its main language is Python, with shell and JavaScript files also in the code.

Source: https://github.com/drowzeys/imagination-studio-by-keys-wasserman
Indexed: commit ef88a07 on 2026-11-11 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Python
- Stars: 1,177 at index time
- License: Apache-2.0
- Code health: 5.4/10, Needs_work
- Last commit: 2026-11-10
- Contributors: 15

## Install

From the README: https://github.com/drowzeys/imagination-studio-by-keys-wasserman

Clone the imagination-studio-by-keys-wasserman repository.
    git clone https://github.com/drowzeys/imagination-studio-by-keys-wasserman.git

Install the Mac prerequisites with Homebrew.
    brew install python@3.11 uv ffmpeg

Change into the cloned repository folder.
    cd Imagination-Studio-by-keys-Wasserman

Run the Mac installer with the app launcher.
    bash oneshot-setup.sh --app

## How it works

Work enters through the Studio interface, which is served by app/server.py, and the app directory holds most of the application code. app/agents.py handles agent access, and agents such as Claude Code and Codex read STUDIO-AGENT.md and use the MCP tools described in mcp/README.md. Every render and processing task goes through the Studio's own queue, which checks memory use and unloads its idle modules before it starts a job. Rendering on NVIDIA hardware is handled by spark/spark_generate.py, and scripts/app.sh launches the app on Linux. Project output is kept in the ImaginationStudio folder under the home directory, or in the location set by STUDIO_HOME.

- app/server.py: entry point
- .github/workflows/tests.yml: central file
- AGENTS.md: central file
- BRAINS.md: central file
- CREDITS.md: central file
Modules: tests, app, scripts, spark, root, mac, mcp. 453 files, 92,033 lines, 7,527 symbols.

## Code health

- Score: 5.4/10 (Needs_work)
- Rank: #234 of 4,000+ indexed repos
- Hotspots: app/server.py, app/agents.py, spark/spark_generate.py, app/voice.py, app/static/machine.js
- Lowest file: app/server.py
- Dead code: 16 findings

## Maintenance

- Last commit 2026-11-10, first commit 2026-10-04, 605 commits
- 15 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/drowzeys/imagination-studio-by-keys-wasserman/security

## More

- Page: https://repowise.dev/repo/drowzeys/imagination-studio-by-keys-wasserman
- Ask this codebase: https://repowise.dev/repo/drowzeys/imagination-studio-by-keys-wasserman/chat
- Docs: https://repowise.dev/repo/drowzeys/imagination-studio-by-keys-wasserman/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/drowzeys/imagination-studio-by-keys-wasserman
