Skip to content

drftstatic/TFCG-FVR-SUITE

TFCG FVR SUITE — Save and Share Your AI Creative Projects

CI License: MIT Node Tests

Quick Links: QuickstartPhilosophyCommunityContributingTestingPress 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: .FVR files are like project files for AI creativity - think of them as Photoshop's .PSD files, but for AI-generated content. Everything in one place.


For Everyone: What You Can Do With FVR Files

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 .fvr file 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

For Creators: Why This Matters

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)


For Developers: Technical Details

Development Status

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 ./unpacked
What 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.


Use Cases

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


Get Started

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


The Vision

"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 & Community

License: MIT (free and open source) Contributing: See CONTRIBUTING.md Code of Conduct: See CODE_OF_CONDUCT.md


© 2025 TFCG / Fladry Creative Group

About

Universal file format for AI-generated creative projects

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors