diff --git a/README.es-ES.md b/README.es-ES.md
new file mode 100644
index 0000000..721e76a
--- /dev/null
+++ b/README.es-ES.md
@@ -0,0 +1,180 @@
+
+
+🔮 Potion
+
+> [!NOTE]
+>
+> Potion es una plataforma de toma de notas impulsada por IA que transforma tus pensamientos en conocimiento inteligente y buscable. Aprovechando las avanzadas capacidades de IA de MindsDB, Potion permite búsqueda semántica, resúmenes generados por IA y asistencia de chat inteligente para que tus notas sean realmente inteligentes.
+
+## 🎬 Presentación del Proyecto
+
+| Video de demostración | Publicación en el blog |
+| ---------------- | ------------- |
+| [](https://youtu.be/W2UIFzpttEE?si=zrNJWTBrltqWLQ4z) | [](https://dev.to/abhinav-writes/meet-potion-your-smart-note-taking-companion-3bb8) |
+
+## 🌟 Características
+
+> **Potion** transforma tu experiencia de toma de notas con:
+
+- 🔍 **Búsqueda impulsada por IA** – Encuentra notas usando consultas en lenguaje natural con comprensión semántica y clasificación por relevancia
+- 📝 **Resúmenes inteligentes** – Genera instantáneamente resúmenes concisos con IA de cualquier nota para extraer ideas clave
+- 💬 **Chat inteligente** – Conversa con tu asistente de IA sobre tus notas y recibe respuestas contextualizadas
+- 🏷️ **Categorías organizadas** – Ordena fácilmente las notas en categorías (Clase, Reunión, Personal, Investigación, Ideas)
+- ⚡ **Sincronización en tiempo real** – Trabaja sin problemas con persistencia en localStorage y sincronización en la nube de MindsDB
+- 🎨 **Interfaz moderna** – Disfruta de un diseño de notas adhesivas moderno con animaciones fluidas y diseño responsivo
+
+## 💻 Instalación
+
+### Requisitos previos
+
+- Node.js (v18+)
+- npm o yarn
+- Docker Desktop (para MindsDB)
+
+### Configuración rápida
+
+1. **Clonar el repositorio**
+
+```bash
+git clone https://github.com/abhinavthedev/potion.git
+cd potion
+```
+
+2. **Iniciar MindsDB**
+
+```bash
+# Iniciar el contenedor de MindsDB
+docker-compose up -d
+
+# Consola de MindsDB: http://127.0.0.1:47334
+```
+
+3. **Configurar claves API**
+
+ - Crea un archivo `.env` a partir de `.env.sample` con lo siguiente:
+
+```
+# Configuración de Azure OpenAI
+api_key=your_azure_openai_api_key
+api_base_url=https://your-resource-name.openai.azure.com
+embed_api_key=your_azure_embedding_api_key
+embed_api_base_url=https://your-embedding-resource.openai.azure.com
+
+# API de Google Cloud
+GOOGLE_API_KEY=your_google_api_key
+
+# Configuración de MindsDB
+MindsDB_URL=http://127.0.0.1:47334
+```
+
+> [!TIP]
+> Obtén las claves API en [Azure OpenAI](https://ai.azure.com/) (despliega los modelos GPT-4 y text-embedding-3-small) y [Google AI Studio](https://aistudio.google.com/app/apikey)
+
+4. **Instalar y ejecutar**
+
+```bash
+npm install
+npm run dev
+
+# Acceder en: http://localhost:3000
+```
+
+5. **Inicializar funciones de IA**
+ - Crea tus primeras notas
+ - Haz clic en el botón "Initiate AI Magic"
+ - Comienza a buscar y chatear con tus notas
+
+## 🛠️ Tecnologías utilizadas
+
+| Categoría | Tecnologías |
+|----------|--------------|
+| **Frontend** | Vanilla JavaScript, CSS3, HTML5 |
+| **Backend** | Node.js, Express.js |
+| **IA y ML** | MindsDB, Azure OpenAI (GPT-4 & Embeddings), Google Gemini, ChromaDB |
+| **Infraestructura** | Docker |
+
+## 🚀 Uso
+
+### Crear notas
+1. Haz clic en el botón **Add Note**
+2. Introduce el título, selecciona la categoría y escribe el contenido
+3. Guarda para crear tu nota
+
+### Búsqueda impulsada por IA
+1. Activa las capacidades de IA
+2. Usa la barra de búsqueda inferior con lenguaje natural
+3. Visualiza los resultados clasificados por relevancia
+
+### Resúmenes de IA y Chat
+- Haz clic en cualquier nota y selecciona **Generate AI Summary**
+- Usa el icono de chat (esquina inferior derecha) para hacer preguntas sobre tus notas
+
+## 📁 Estructura del proyecto
+
+```
+potion/
+├── public/ # Recursos del frontend
+│ ├── index.html # Interfaz HTML principal
+│ ├── style.css # Estilos y animaciones
+│ └── script.js # Lógica del frontend
+├── utils/ # Funciones auxiliares
+├── app.js # Servidor Express
+├── mindsdb.js # Integración con MindsDB
+├── setup.js # Configuración inicial
+├── docker-compose.yml # Configuración de Docker
+└── .env.sample # Ejemplo de variables de entorno
+```
+
+## 🔧 Endpoints de la API
+
+| Método | Endpoint | Descripción |
+|--------|----------|-------------|
+| POST | `/api/setup` | Inicializar el proyecto de MindsDB |
+| POST | `/api/mindsdb/initialize` | Configurar la base de conocimientos y los modelos |
+| POST | `/api/notes/search` | Búsqueda semántica en las notas |
+| POST | `/api/notes/summarize` | Generar resúmenes de notas |
+| POST | `/api/chat` | Chatear con la IA sobre las notas |
+| POST | `/api/upload` | Subir notas a MindsDB |
+
+## 🐛 Solución de problemas
+
+| Problema | Solución |
+|-------|----------|
+| **MindsDB no accesible** | • Asegúrate de que Docker esté en ejecución
• Verifica el contenedor: `docker ps`
• Reiniciar: `docker-compose restart mindsdb`
• Verifica que el puerto 47334 esté disponible |
+| **Funciones de IA no funcionan** | • Verifica el estado de MindsDB
• Verifica las claves API
• Asegúrate de que existan notas antes de activar la IA |
+| **La búsqueda no devuelve resultados** | • Confirma la activación de la IA
• Prueba con términos de búsqueda más amplios
• Verifica la conexión con MindsDB |
+
+> [!NOTE]
+> Para obtener ayuda detallada con la instalación, consulta la [Documentación de Instalación de MindsDB](https://docs.mindsdb.com/setup/self-hosted/docker#install-mindsdb)
+
+## 🤝 Contribuir
+
+1. Haz un fork del repositorio
+2. Crea una rama de funcionalidad: `git checkout -b feature/amazing-feature`
+3. Confirma tus cambios: `git commit -m 'Add amazing feature'`
+4. Empuja a la rama: `git push origin feature/amazing-feature`
+5. Abre un Pull Request
+
+## 📄 Licencia
+
+Potion está licenciado bajo la `Unlicense`. Consulta el archivo LICENSE para más detalles.
+
+## 👤 Autor
+
+
+
+---
+
+🌟 ¡Si encuentras Potion útil, por favor dale una estrella en GitHub! 🌟
+