Claude Agent
9ca770962f
Hardening pass over the quickstart repo to make it match the actual d0a1.es stack and remove long-standing drift. - README: align with 8 GB RAM reality across all sections, add explicit security warning on WEBUI_AUTH=false, remove dead link to d0a1.es/vps, drop stack services not part of d0a1.es (n8n, WordPress, Qdrant). Re-point the d0a1 section to the services that actually run at git/mail/app.d0a1.es. - docker-compose: move all tunables (ports, default model, auth, secret key, keep-alive) to .env with sensible defaults. Add commented GPU passthrough block for NVIDIA hosts. - deploy.sh: pre-flight checks (docker, compose, daemon), copy .env.example on first run, auto-detect system RAM on Linux and macOS and warn on sub-8 GB hosts. - Add .env.example documenting every variable and required RAM per model. - Add MIT LICENSE (was promised in README but missing). - Add .gitignore (local .env, editor cruft, OS junk). - .gitattributes: use a single rule (text=auto eol=lf) to cover every text file, not just *.sh - fixes CRLF warnings on new text files on Windows checkouts. Refs: d0a1/quickstart rename (companion: new repo at git.d0a1.es/d0a1/quickstart).
181 lines
5.6 KiB
Markdown
181 lines
5.6 KiB
Markdown
# 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).
|
|
|
|
Este repo forma parte del ecosistema **d0a1.es**: un conjunto de servicios
|
|
self-hosted que demuestran que la IA útil no requiere ceder tus datos a
|
|
terceros. El quickstart es la puerta de entrada: el resto de servicios
|
|
(Gitea, mail, aplicaciones internas) están disponibles bajo el mismo paraguas
|
|
en [d0a1.es](https://d0a1.es).
|
|
|
|
## 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 |
|
|
|
|
> **Importante:** con 8 GB de RAM, usa modelos de hasta 7B cuantizados (Q4).
|
|
> Los modelos de 8B funcionan en CPU pero pueden ralentizar el sistema bajo carga.
|
|
|
|
## Instalación
|
|
|
|
### Opción rápida (recomendada)
|
|
|
|
```bash
|
|
git clone https://git.d0a1.es/d0a1/quickstart.git
|
|
cd quickstart
|
|
cp .env.example .env
|
|
./deploy.sh
|
|
```
|
|
|
|
### Opción manual
|
|
|
|
```bash
|
|
git clone https://git.d0a1.es/d0a1/quickstart.git
|
|
cd quickstart
|
|
cp .env.example .env
|
|
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.
|
|
|
|
## Configuración
|
|
|
|
Toda la configuración se gestiona vía el archivo `.env` (copia `.env.example`):
|
|
|
|
| Variable | Por defecto | Descripción |
|
|
|----------|-------------|-------------|
|
|
| `WEBUI_PORT` | 3000 | Puerto de Open WebUI |
|
|
| `OLLAMA_PORT` | 11434 | Puerto de Ollama |
|
|
| `WEBUI_AUTH` | `true` | Si `false`, desactiva el login. **Recomendado solo para uso personal en local** — no exponer a internet sin autenticación. |
|
|
| `DEFAULT_MODEL` | `llama3.2:3b` | Modelo que Open WebUI sugiere al registrarse |
|
|
| `OLLAMA_KEEP_ALIVE` | `5m` | Tiempo que Ollama mantiene un modelo en memoria tras usarlo |
|
|
| `WEBUI_SECRET_KEY` | *(generar)* | Clave de sesión de Open WebUI. **Cámbiala en producción.** Genera una con: `openssl rand -hex 32` |
|
|
|
|
## Añadir modelos
|
|
|
|
Cuanta más RAM tengas, mejores modelos puedes usar:
|
|
|
|
```bash
|
|
# Mejor en español (8 GB RAM)
|
|
docker exec d0a1-ollama ollama pull qwen2.5:7b
|
|
|
|
# Más inteligente (8 GB RAM)
|
|
docker exec d0a1-ollama ollama pull llama3.1:8b
|
|
|
|
# Para programar (8 GB RAM)
|
|
docker exec d0a1-ollama ollama pull codellama:7b
|
|
|
|
# Listar modelos instalados
|
|
docker exec d0a1-ollama ollama list
|
|
```
|
|
|
|
> Los tiempos de respuesta de los modelos grandes son sensiblemente mejores
|
|
> con GPU. En CPU funcionan, pero pueden tardar varios segundos por respuesta.
|
|
|
|
## 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 incluye servicios
|
|
auto-hospedados en [d0a1.es](https://d0a1.es):
|
|
|
|
- **git.d0a1.es** — Gitea, repositorios Git con Pull Requests y code review
|
|
- **mail.d0a1.es** — Webmail SnappyMail
|
|
- **app.d0a1.es** — Aplicaciones internas
|
|
- **Hermes Agent** — Agente autónomo con memoria, skills y 14+ plataformas
|
|
|
|
Todos los servicios son open source, usan solo HTTPS 443 y se pueden
|
|
ejecutar en una sola máquina.
|
|
|
|
## 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.
|
|
|
|
## 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.
|
|
|
|
### El modelo no carga / `model requires more system memory`
|
|
|
|
Has intentado descargar un modelo demasiado grande para tu RAM. Elimínalo
|
|
y prueba con uno más pequeño:
|
|
|
|
```bash
|
|
docker exec d0a1-ollama ollama rm llama3.1:8b
|
|
docker exec d0a1-ollama ollama pull llama3.2:3b
|
|
```
|
|
|
|
### Open WebUI no arranca / `address already in use`
|
|
|
|
Tienes otro servicio en el puerto 3000 (o el que configuraste en `.env`).
|
|
Cámbialo en `.env`:
|
|
|
|
```bash
|
|
WEBUI_PORT=8080
|
|
```
|
|
|
|
Y reinicia: `docker compose down && docker compose up -d`.
|
|
|
|
## Licencia
|
|
|
|
MIT. Usa, modifica y comparte libremente.
|
|
|
|
---
|
|
|
|
[d0a1.es](https://d0a1.es) — Humano decides, agente ejecuta.
|