feat: quickstart stack - Ollama + Open WebUI

- docker-compose.yml: minimal local AI stack - deploy.sh: automated deployment with Docker/RAM checks - README.md: landing page with model selection table
2026-06-13 23:03:22 +02:00
commit f2ef809fc8
3 changed files with 289 additions and 0 deletions
@@ -0,0 +1,117 @@
+# d0a1 quickstart — IA agéntica local, sin coste, sin VPS
+
+> **Prueba IA local en tu ordenador. Gratis. Sin cuenta. Sin API key. En 3 minutos.**
+
+## Qué es esto
+
+Un comando y tendrás un asistente de IA corriendo **en tu propia máquina**.
+Sin enviar datos a terceros. Sin pagar por tokens. Sin crear cuentas.
+Usa modelos de lenguaje de código abierto (Ollama) con una interfaz web moderna (Open WebUI).
+
+## Requisitos
+
+| Requisito | Mínimo | Recomendado |
+|-----------|--------|-------------|
+| RAM | 8 GB | 16 GB |
+| Disco | 5 GB libres | 20 GB |
+| Sistema | Linux, macOS, Windows (WSL2) | Linux |
+| Software | Docker + Docker Compose v2 | Docker + Docker Compose v2 |
+
+## Instalación
+
+### Opción rápida (recomendada)
+
+```bash
+git clone https://github.com/d0a1-es/quickstart.git
+cd quickstart
+./deploy.sh
+```
+
+### Opción manual
+
+```bash
+git clone https://github.com/d0a1-es/quickstart.git
+cd quickstart
+docker compose up -d
+# Esperar ~30s a que Ollama arranque
+docker exec d0a1-ollama ollama pull llama3.2:3b
+```
+
+Abre tu navegador en **http://localhost:3000**
+
+## Qué incluye
+
+- **Ollama** — Motor de IA local. Los modelos corren en tu máquina, no en la nube.
+- **Open WebUI** — Interfaz web tipo ChatGPT, pero local y privada.
+- **llama3.2:3b** — Modelo inicial ligero (~2 GB). Buen punto de partida.
+
+## Añadir modelos
+
+Cuanta más RAM tengas, mejores modelos puedes usar:
+
+```bash
+# Mejor en español (5 GB RAM)
+docker exec d0a1-ollama ollama pull qwen2.5:7b
+
+# Más inteligente (6 GB RAM)
+docker exec d0a1-ollama ollama pull llama3.1:8b
+
+# Para programar (5 GB RAM)
+docker exec d0a1-ollama ollama pull codellama:7b
+
+# Listar modelos instalados
+docker exec d0a1-ollama ollama list
+```
+
+## Comandos
+
+```bash
+docker compose logs -f     # Ver logs en tiempo real
+docker compose down         # Parar todo (los datos se conservan)
+docker compose down -v      # Borrar todo, incluidos los datos
+docker exec d0a1-ollama ollama pull MODELO   # Descargar otro modelo
+```
+
+## ¿Y después?
+
+Esto es solo el principio. El stack completo d0a1 añade:
+
+- **Hermes Agent** — Agente autónomo con memoria, skills y 14+ plataformas
+- **n8n** — Automatizaciones visuales sin código
+- **Qdrant** — Base de datos vectorial para búsqueda semántica
+- **WordPress** — CMS con IA integrada
+- **Correo, backups, HTTPS** — Todo automatizado
+
+Si la IA local te sabe a poco, despliega el stack completo en un VPS:
+
+**[d0a1.es/vps](https://d0a1.es/vps)** — Desde 6€/mes, todo incluido
+
+## Preguntas frecuentes
+
+### ¿Es realmente gratis?
+
+Sí. Los modelos de Ollama son de código abierto. No pagas por tokens.
+Solo consumes la electricidad de tu ordenador.
+
+### ¿Mis datos salen de mi máquina?
+
+No. Ollama corre localmente. Los datos no se envían a ningún servidor.
+Open WebUI también es local. Tu historial de chat se queda en tu disco.
+
+### ¿Necesito una GPU?
+
+No. Los modelos funcionan en CPU. Una GPU hace que vaya más rápido,
+pero no es necesaria. Con 8 GB de RAM ya puedes usar llama3.2:3b.
+
+### ¿Puedo usar esto para trabajar?
+
+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.
+
+## Licencia
+
+MIT. Usa, modifica y comparte libremente.
+
+---
+
+[d0a1.es](https://d0a1.es) — Humano decides, agente ejecuta.