diff --git a/README.md b/README.md
new file mode 100644
index 0000000..211d80e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# Yeri AI: working notes for image and video generation
+
+[Yeri AI](https://yeri.ai) is a browser-based studio for generating images and short videos from text prompts or reference photos. I keep the notes in a repo because prompts drift: a wording that worked last month may need a tweak after a model update, and the history makes that easy to see.
+
+![Yeri AI example](example.jpg)
+
+## Templates
+
+The prompt library is useful when you are stuck: copy a prompt, change the subject, keep the lighting and composition terms. Video templates and photo effects are the fastest way to get something social-ready; swap in your own photo and adjust the text.
+
+## Editing tools
+
+The image expander (outpainting) is handy for turning a square photo into a 16:9 banner without cropping the subject. The background remover is good enough for marketplace product photos; check hair and glass edges before publishing.
+
+## Models
+
+Model choice matters more than prompt length. Fast models are fine for exploring ideas; switch to a pro model only for the final render to save credits. Yeri AI lets you choose the model per job. Seedream is my pick for detailed product shots, Nano Banana for fast drafts and multi-reference edits, and GPT Image when the picture has to contain readable text.
+
+## Use cases
+
+Marketers, e-commerce sellers, designers and video creators are the people who get the most out of it. I mostly use it for blog headers and short social videos, but it also works for quick mockups when pitching an idea.
+
+## Image prompts
+
+Short, concrete nouns beat long lists of adjectives. 'Rainy Tokyo alley at night, neon reflections' works better than ten style words. When matching a brand look, upload one or two reference images and describe only what should change; the model keeps the rest.
+
+## Links
+
+Try it here: https://yeri.ai
+
+I update this file when a workflow changes.
\ No newline at end of file