diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1eef533
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# Yeri AI: working notes for image and video generation: my current workflow
+
+[Yeri AI](https://yeri.ai) bundles text-to-image, image-to-image, text-to-video and image-to-video generation into one web app, and this repo collects what I learned using it. The goal is a short, honest reference: what each part of the tool is good at, and where it still needs a second pass.
+
+![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.
+
+## Tips
+
+- Check hands, text and logos at full size before publishing.
+- Use the same reference image across a series to keep characters consistent.
+- Generate four variations, pick one, then iterate on that one only.
+
+## Use cases
+
+I mostly use it for blog headers and short social videos, but it also works for quick mockups when pitching an idea. Marketers, e-commerce sellers, designers and video creators are the people who get the most out of it.
+
+## Image prompts
+
+Start with the subject, then the setting, then light and lens. For example: 'ceramic mug on a linen table, soft window light from the left, 50mm, shallow depth of field'. When matching a brand look, upload one or two reference images and describe only what should change; the model keeps the rest.
+
+## Editing tools
+
+The background remover is good enough for marketplace product photos; check hair and glass edges before publishing. Upscaling and enhancement fix soft or low-resolution sources before you animate them, which noticeably improves video results.
+
+## Models
+
+I usually draft on a lighter model, keep the seed and prompt, then re-render the best two or three on a higher-quality model. 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.
+
+## Links
+
+Website: https://yeri.ai
+
+I update this file when a workflow changes.
\ No newline at end of file