https://github.com/saagpatel/visual-album-studio
Music-synced visual video generator — deterministic export pipelines with resumable bundles and DR rehearsal
https://github.com/saagpatel/visual-album-studio
ai automation export-pipeline fastapi ghra-call-security-review ghra-lens-security-posture ghra-next-review-code-scanning-alerts ghra-security-high local-first music-visualization python video-generation
Last synced: about 15 hours ago
JSON representation
Music-synced visual video generator — deterministic export pipelines with resumable bundles and DR rehearsal
- Host: GitHub
- URL: https://github.com/saagpatel/visual-album-studio
- Owner: saagpatel
- License: mit
- Created: 2026-03-21T22:30:42.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-10T10:47:48.000Z (19 days ago)
- Last Synced: 2026-06-10T12:22:00.484Z (19 days ago)
- Topics: ai, automation, export-pipeline, fastapi, ghra-call-security-review, ghra-lens-security-posture, ghra-next-review-code-scanning-alerts, ghra-security-high, local-first, music-visualization, python, video-generation
- Language: Python
- Size: 617 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Visual Album Studio
[](#) [](#)
> Your music, made visual — frame-accurate, resumable, and ready to distribute.
Visual Album Studio is a local-first desktop application for generating music-synced visual videos with deterministic, resumable export pipelines and optional distribution integrations. V1 and V2 are complete; the next-cycle roadmap covers provider policy watching, anomaly auto-triage, and scheduler simulation overlays.
## Features
- **Music-synced video generation** — frame-accurate visual output aligned to audio beat and structure
- **Deterministic export** — same inputs always produce the same output; full content hashing with BLAKE3
- **Resumable pipelines** — interrupted exports resume from the last verified checkpoint
- **DR rehearsal automation** — non-destructive disaster recovery rehearsal built into the verification suite
- **Anomaly auto-triage** — enriched anomaly detection with structured triage output
- **Provider policy watching** — NC-003 diff watcher ingests provider changelog and emits recommendations
- **Replay actor-filter correctness** — redaction-safe raw exports with verified replay integrity
- **Distribution integrations** — optional hooks for YouTube and other platforms
## Quick Start
### Prerequisites
- Python 3.11+
- ffmpeg
### Installation
```bash
git clone https://github.com/saagpatel/visual-album-studio
cd visual-album-studio
pip install -r app/requirements.txt
```
### Usage
```bash
# Run strict verification
env VAS_SECURITY_STRICT=1 bash .codex/scripts/run_verify_commands.sh
# Run capstone audit (requires test video)
env VAS_SECURITY_STRICT=1 \
VAS_YT_TEST_VIDEO_PATH=/path/to/test_video.mp4 \
./scripts/test/capstone_audit.sh
```
## Tech Stack
| Layer | Technology |
|-------|------------|
| Language | Python 3.11+ |
| Core | Custom pipeline engine (vas_studio) |
| Export verification | BLAKE3 content hashing |
| Database | SQLite (migrations in migrations/) |
| Testing | pytest (unit, integration, acceptance) |
## License
MIT