diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..95b0487
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,10 @@
+# Garantiza que los scripts se guarden con saltos de línea Unix (LF),
+# incluso en clones desde Windows. Evita que `bash deploy.sh` rompa
+# con errores tipo "$'\r': command not found" en WSL / Git Bash.
+*.sh        text eol=lf
+*.bash      text eol=lf
+
+# Documentación también en LF para consistencia.
+*.md        text eol=lf
+*.yml       text eol=lf
+*.yaml      text eol=lf
diff --git a/README.md b/README.md
index 0d68ef8..3b019e2 100644
--- a/README.md
+++ b/README.md
@@ -108,6 +108,22 @@ pero no es necesaria. Con 8 GB de RAM ya puedes usar llama3.2:3b.
 Claro. Los modelos de 7-14B son útiles para redacción, traducción,
 resumen, código, SEO y mucho más. Cuanta más RAM, mejor calidad.
 
+## Troubleshooting
+
+### `set: usage:` o `$'\r': command not found` al ejecutar `deploy.sh` (WSL / Git Bash)
+
+El archivo llegó con saltos de línea de Windows (CRLF). El repositorio
+incluye `.gitattributes` para que esto no pase al clonarlo, pero si ya
+lo tienes descargado con CRLF, normalo a Unix:
+
+```bash
+sed -i 's/\r$//' deploy.sh && ./deploy.sh
+```
+
+Esto ocurre sobre todo cuando se descarga el archivo desde un navegador
+en Windows o se edita con el bloc de notas. Con `git clone` desde
+cualquier sistema queda en LF automáticamente.
+
 ## Licencia
 
 MIT. Usa, modifica y comparte libremente.