Update README.md

README.md

@@ -2,4 +2,234 @@
 license: other
 license_name: krea2
 license_link: https://huggingface.co/krea/Krea-2-Turbo/blob/main/LICENSE.pdf
+library_name: diffusers
+pipeline_tag: text-to-image
+tags:
+- text-to-image
+- checkpoint
+- finetuned
+- krea2
+- realism
+- fp8
+- cinematic
+base_model:
+- krea/Krea-2-Turbo
 ---
+
+---
+
+# Serendipity — The Director’s Checkpoint - V2
+
+
+**Serendipity** is a Krea 2 Turbo checkpoint built for creators who want more than another close-up portrait generator.
+
+Where many checkpoints have a tendency to pull scenes inward toward faces and tight compositions, **Serendipity behaves more like a film director** — responding strongly to camera placement, spatial depth, environmental scale, blocking, movement, and complex multi-subject stage direction.
+
+It was created specifically with **cinematic storytelling and photographic composition** in mind.
+
+Whether you are:
+
+* storyboarding a film,
+* building comic panels,
+* creating atmospheric concept art,
+* composing cinematic stills, or
+* generating high-energy action sequences,
+
+Serendipity is designed to give you greater control over **where the camera is, where the subject is, and what is happening inside the frame.**
+
+---
+### Sample Generations
+
+<table>
+  <tr>
+    <td><img src="images/01.png" width="100%" alt="Serendipity sample 01"></td>
+    <td><img src="images/02.png" width="100%" alt="Serendipity sample 02"></td>
+    <td><img src="images/03.png" width="100%" alt="Serendipity sample 03"></td>
+  </tr>
+  <tr>
+    <td><img src="images/04.png" width="100%" alt="Serendipity sample 04"></td>
+    <td><img src="images/05.png" width="100%" alt="Serendipity sample 05"></td>
+    <td><img src="images/06.png" width="100%" alt="Serendipity sample 06"></td>
+  </tr>
+</table>
+
+---
+
+
+## How Serendipity Was Made
+
+Serendipity did not begin as a synthetic merge recipe.
+
+Its foundation was a **LoRA trained on a carefully curated collection of my own older photography from my former studio**.
+
+The training dataset was selected manually from my photographic archive and **hand-tagged image by image**, with an emphasis on the visual principles I wanted the model to learn from real photography:
+
+* Composition
+* Subject placement
+* Environmental depth
+* Camera distance
+* Lighting
+* Perspective
+* Motion
+* Visual storytelling
+* Photographic atmosphere
+
+**No automated tagging pipeline was used for the core dataset.**
+
+The LoRA was then trained, evaluated through repeated generations, refined through testing, and ultimately **merged directly into the official Krea 2 Turbo base checkpoint** to create Serendipity as a permanent standalone model.
+
+This distinction is important.
+
+Unlike **Soliloquy**, which evolved through a different merged-checkpoint lineage, **Serendipity is built directly on the official Krea 2 Turbo base**.
+
+The intention was not simply to make Krea 2 *look different*.
+
+The goal was to inject photographic composition and cinematic staging learned from real-world photography while preserving the capabilities of the original base as much as possible.
+
+Serendipity is therefore best thought of as a:
+
+> **Photography-derived directional refinement of Krea 2 Turbo, focused on composition, spatial awareness, cinematic staging, and visual storytelling.**
+
+---
+
+## Design Philosophy
+
+Serendipity was built around a simple idea:
+
+**A strong image model should understand the scene, not just the subject.**
+
+The model is intended to respond more deliberately to instructions involving:
+
+* Wide and environmental compositions
+* Full-body framing
+* Foreground / midground / background separation
+* Over-the-shoulder shots
+* Camera height and camera distance
+* Low-angle and high-angle perspectives
+* Multiple subjects occupying distinct spatial positions
+* Suspended or moving objects
+* Mid-air action
+* Dramatic environmental lighting
+* Scene blocking
+* Narrative interaction between subjects
+* Cinematic depth
+
+Rather than forcing every prompt toward a portrait, Serendipity aims to preserve the **relationship between subject, camera, and environment**.
+
+---
+
+## Best Suited For
+
+Serendipity is particularly well suited to:
+
+* Cinematic photography
+* Narrative scenes
+* Film stills
+* Storyboarding
+* Comic and graphic-novel panels
+* Environmental portraiture
+* Action photography
+* Fantasy and science-fiction scenes
+* Multi-character compositions
+* Atmospheric concept art
+* Dynamic camera perspectives
+* Dramatic lighting
+* Large-scale environments
+
+---
+
+Prompting Tips for Serendipity
+
+
+
+
+
+Use Camera Directions: Serendipity responds heavily to cinematic framing tokens like wide shot, extreme wide shot, over-the-shoulder, low-angle tracking shot, and anamorphic lens flare.
+
+
+
+Describe Stage Action: Don't just prompt a character—prompt what they are doing with their environment (e.g., leaning casually against the wooden bar, flipping a silver coin, mid-air acrobatic leap).
+
+
+
+Layer Your Depth: Mention elements in the foreground, mid-ground, and background to activate Serendipity’s deep bokeh engine.
+
+---
+
+## Licensing & Disclaimer
+- **Original Model Creators**: All credit goes to [KREA.ai](https://www.krea.ai) for the original research, architecture, and weights.
+- **License**: This model is subject to the **KREA 2 License Agreement**. Please read and comply with the official license terms before using these weights: [KREA 2 Licensing Terms](https://www.krea.ai/krea-2-licensing).
+
+---
+
+## Model Lineage
+
+**Base:** Official Krea 2 Turbo checkpoint
+**Refinement:** Custom photography-trained LoRA
+**Dataset:** Personally curated real-world photography
+**Captioning:** Manual / hand-tagged
+**Final Model:** LoRA merged permanently into the Krea 2 Turbo base
+
+No synthetic imagery was used as the foundation of the photographic training dataset.
+
+---
+
+
+## Variants
+
+### Current
+
+* **Fp8**
+* **BF16**
+* **Int8ConvRot**
+
+### Coming Soon
+* **Serendipity-V2**
+
+
+Serendipity is an ongoing project, and future versions will continue refining composition, cinematic staging, lighting behavior, spatial awareness, and photographic character.
+
+---
+
+## Version Notes — V1
+
+This is the **first public release of Serendipity**.
+
+V1 establishes the core direction of the model:
+
+* stronger environmental composition,
+* improved camera-distance control,
+* cinematic scene staging,
+* dynamic action,
+* multi-subject framing,
+* photographic lighting,
+* and greater emphasis on spatial relationships within the image.
+
+This is not intended to be the final form of the model.
+
+Serendipity will continue evolving as I test new training data, refinements, quantization approaches, and model-development techniques.
+
+
+---
+
+## Final Note
+
+Serendipity grew out of photography rather than a desire to simply create another aesthetic checkpoint.
+
+The photographs used to build its original LoRA represent years of real-world experimentation with cameras, subjects, lighting, framing, and composition.
+
+The goal of the project is to carry some of that photographic intuition into a generative model.
+
+Not just:
+
+**“What should the subject look like?”**
+
+But:
+
+**“Where is the camera?”**
+**“Where is the subject?”**
+**“What is the environment doing?”**
+**“Where is the light coming from?”**
+**“What is happening in this frame?”**
+
+That is the idea behind **Serendipity — The Director’s Checkpoint.**