Quick Links: Quickstart • Philosophy • Community • Contributing • Testing • Press Kit
The Problem: You create amazing images, videos, or audio with AI tools like DALL-E, Midjourney, or others. But where's the "save file"? How do you remember what you asked for? What if you want to recreate something similar later, or share your process with others?
The Solution:
.FVRfiles are like project files for AI creativity - think of them as Photoshop's.PSDfiles, but for AI-generated content. Everything in one place.
Save Your Creative Journey
- Keep all your AI prompts, images, and variations in one organized package
- Remember exactly what you asked the AI to make
- See your creative evolution - which version led to your final masterpiece
Share Your Process
- Send a single
.fvrfile to collaborators with everything they need - Other creators can learn from your prompt techniques
- No more "how did you make that?" - it's all documented
Real Examples:
- Wedding photographer: Generate 20 invitation designs, save all variations with prompts, share finalist options with the couple in one file
- Musician: Create album art through 50+ AI iterations, keep the whole exploration documented
- Small business owner: Design logo variations, track which prompts worked, share with your designer
The Adobe Comparison:
When you work in Photoshop, you get a .PSD file with all your layers, history, and settings. When you work with AI image generators, you usually get... just a JPG and maybe copy/paste your prompt somewhere.
FVR gives you:
- 📦 Project file format - everything packaged together
- 🔄 Replayability - regenerate with different AI tools
- 🎨 Style presets - save and reuse your favorite settings
- 💰 Cost tracking - see how much each generation cost
- 🌳 Version tree - see parent/child relationships between iterations
Works with: DALL-E, Midjourney, Stable Diffusion, Google Imagen, and any AI image/video/audio tool (through adapters)
Current Phase: Specification & Reference Implementation (v1.0)
- ✅ Format specification complete and stable
- ✅ JSON Schema validation
- ✅ Provider adapter interfaces defined
- ✅ Reference implementations for 9 providers
- ✅ Comprehensive test suite (44 tests, 28 passing)
- 🚧 CLI tools in active development
- 🚧 Full adapter API integration in progress
Test Coverage: Schema validation, adapter interfaces, CLI commands Seeking: Community feedback on specification, adapter contributions, use case validation
We're prioritizing spec stability over implementation completeness. The format is ready for evaluation and contribution - implementations will follow community feedback.
Quick Start - CLI Installation
# Install the CLI in dev mode (requires Node 20+ / pnpm or npm)
cd packages/cli
pnpm i # or: npm i
pnpm build
pnpm link # or: npm link
# Validate an example manifest
fvr validate ../../examples/quick-concept.fvrdir/fvr.json --schema ../../schemas/fvr-1.0.0.schema.json
# Pack a .fvr from a working directory
fvr pack ../../examples/quick-concept.fvrdir --out quick-concept.fvr
# Unpack a .fvr into a working directory
fvr unpack quick-concept.fvr --out ./unpackedWhat is `.FVR` Technically?
A provider-agnostic, replayable creative project container (zip-based) that bundles:
- Chat history and prompts
- All generated outputs and selections
- Seeds, model/version info, and capability snapshots
- A refinement tree (parent/child generations)
- Provenance, cost ledger, checksums
- Community style presets applied at creation time
This repo ships a schema, examples, CLI, adapter interface, and press kit.
Repo Structure
TFCG-FVR-SUITE/
├─ docs/ # Specification and brand guidelines
├─ schemas/ # JSON Schema validation
├─ packages/
│ ├─ cli/ # TypeScript CLI tools
│ └─ adapters/ # Provider integration stubs
├─ examples/ # Sample .fvr projects
└─ press-kit/ # Logos and marketing materials
Provider Support
Current adapter stubs:
- Google: Gemini 2.5 Flash, Imagen 4.0, Veo 3
- OpenAI: DALL-E 3
- Stability AI: Stable Diffusion (in progress)
- More coming soon
See packages/adapters/ for implementation details.
Creative Studios: Manage client projects with full AI generation history AI Artists: Document and share your creative process Agencies: Standardize AI workflows across teams Educators: Teach prompt engineering with real examples Researchers: Study AI model behavior and evolution
Just exploring? → Check out the examples folder for ready-made FVR projects Want to create FVR files? → See the Quick Start guide Building integrations? → Read the technical spec Contributing code? → See TESTING.md and CONTRIBUTING.md Press/Media? → Grab assets from the press kit
"If Adobe died in its sleep and came back talking backwards."
AI creative tools are powerful, but they're missing project files. FVR brings professional creative workflow standards to AI generation. Own your process. Share your journey. Build on others' work.
License: MIT (free and open source) Contributing: See CONTRIBUTING.md Code of Conduct: See CODE_OF_CONDUCT.md
© 2025 TFCG / Fladry Creative Group