fix: align quickstart with d0a1.es ecosystem and current reality
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).
This commit is contained in:
Claude Agent
@@ -1,116 +1,114 @@
|
||||
#!/bin/bash
|
||||
# ──────────────────────────────────────────────
|
||||
# d0a1 quickstart — IA agéntica local, sin coste
|
||||
# ──────────────────────────────────────────────
|
||||
# Ejecuta: curl -fsSL https://d0a1.es/quickstart | bash
|
||||
# o: ./deploy.sh
|
||||
# Abre: http://localhost:3000
|
||||
# ──────────────────────────────────────────────
|
||||
set -e
|
||||
#!/usr/bin/env bash
|
||||
# d0a1 quickstart deployment script
|
||||
# Sube Ollama + Open WebUI en Docker. Lee configuracion de .env.
|
||||
set -euo pipefail
|
||||
|
||||
# Colores
|
||||
GREEN='\033[0;32m'
|
||||
CYAN='\033[0;36m'
|
||||
YELLOW='\033[0;33m'
|
||||
RED='\033[0;31m'
|
||||
BOLD='\033[1m'
|
||||
NC='\033[0m'
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
cd "$SCRIPT_DIR"
|
||||
|
||||
echo ""
|
||||
echo -e "${BOLD}${CYAN}╔══════════════════════════════════════════╗${NC}"
|
||||
echo -e "${BOLD}${CYAN}║ d0a1 quickstart — IA local, sin coste ║${NC}"
|
||||
echo -e "${BOLD}${CYAN}╚══════════════════════════════════════════╝${NC}"
|
||||
echo ""
|
||||
# --- Color helpers -----------------------------------------------------------
|
||||
if [ -t 1 ]; then
|
||||
BOLD="\033[1m"; GREEN="\033[32m"; YELLOW="\033[33m"; RED="\033[31m"; RESET="\033[0m"
|
||||
else
|
||||
BOLD=""; GREEN=""; YELLOW=""; RED=""; RESET=""
|
||||
fi
|
||||
info() { printf "%b\n" "${BOLD}${GREEN}>>>${RESET} $*"; }
|
||||
warn() { printf "%b\n" "${BOLD}${YELLOW}>>>${RESET} $*"; }
|
||||
err() { printf "%b\n" "${BOLD}${RED}>>>${RESET} $*" >&2; }
|
||||
|
||||
# ── 1. Comprobar Docker ──────────────────────
|
||||
echo -e "${YELLOW}[1/4]${NC} Comprobando Docker..."
|
||||
# --- Pre-flight checks -------------------------------------------------------
|
||||
|
||||
if ! command -v docker &>/dev/null; then
|
||||
echo -e "${RED}✗ Docker no está instalado.${NC}"
|
||||
echo ""
|
||||
echo "Instálalo primero:"
|
||||
echo " Linux: curl -fsSL https://get.docker.com | sh"
|
||||
echo " macOS: https://docs.docker.com/desktop/install/mac-install/"
|
||||
echo " Windows: https://docs.docker.com/desktop/install/windows-install/"
|
||||
echo ""
|
||||
echo "Y vuelve a ejecutar este script."
|
||||
exit 1
|
||||
if ! command -v docker >/dev/null 2>&1; then
|
||||
err "Docker no esta instalado. Instala Docker Desktop o docker-ce."
|
||||
err "https://docs.docker.com/get-docker/"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if ! docker compose version &>/dev/null; then
|
||||
echo -e "${RED}✗ Docker Compose v2 no está disponible.${NC}"
|
||||
echo "Actualiza Docker: https://docs.docker.com/compose/install/"
|
||||
exit 1
|
||||
if ! docker info >/dev/null 2>&1; then
|
||||
err "Docker daemon no responde. Inicia Docker Desktop o el servicio."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo -e "${GREEN}✓${NC} Docker encontrado: $(docker compose version --short 2>/dev/null || echo 'OK')"
|
||||
|
||||
# ── 2. Comprobar RAM ────────────────────────
|
||||
echo -e "${YELLOW}[2/4]${NC} Comprobando memoria..."
|
||||
|
||||
TOTAL_RAM_KB=$(grep MemTotal /proc/meminfo 2>/dev/null | awk '{print $2}' || echo "0")
|
||||
TOTAL_RAM_GB=$((TOTAL_RAM_KB / 1024 / 1024))
|
||||
|
||||
if [ "$TOTAL_RAM_GB" -lt 6 ]; then
|
||||
echo -e "${RED}✗ Se necesitan al menos 8 GB de RAM (detectado: ${TOTAL_RAM_GB} GB).${NC}"
|
||||
echo "El modelo de IA necesita memoria para funcionar."
|
||||
exit 1
|
||||
if ! docker compose version >/dev/null 2>&1; then
|
||||
err "Docker Compose v2 no esta disponible. Actualiza Docker."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo -e "${GREEN}✓${NC} RAM: ${TOTAL_RAM_GB} GB"
|
||||
# --- Config ------------------------------------------------------------------
|
||||
|
||||
# ── 3. Descargar y arrancar ─────────────────
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
COMPOSE_FILE="$SCRIPT_DIR/docker-compose.yml"
|
||||
|
||||
if [ ! -f "$COMPOSE_FILE" ]; then
|
||||
echo -e "${RED}✗ No encuentro docker-compose.yml junto a este script.${NC}"
|
||||
echo "Asegúrate de ejecutarlo desde la carpeta quickstart/."
|
||||
exit 1
|
||||
if [ ! -f .env ]; then
|
||||
warn "No existe .env, copiando .env.example"
|
||||
cp .env.example .env
|
||||
info "Edita .env si quieres cambiar puertos o el modelo por defecto."
|
||||
fi
|
||||
|
||||
echo -e "${YELLOW}[3/4]${NC} Descargando contenedores (primera vez tarda 2-3 minutos)..."
|
||||
docker compose -f "$COMPOSE_FILE" up -d
|
||||
# Carga .env sin requerir bash 4+ (compatible con macOS)
|
||||
set -a
|
||||
# shellcheck disable=SC1091
|
||||
. ./.env
|
||||
set +a
|
||||
|
||||
# ── 4. Descargar modelo ─────────────────────
|
||||
echo -e "${YELLOW}[4/4]${NC} Descargando modelo de IA (llama3.2:3b, ~2 GB)..."
|
||||
echo " Esto también solo ocurre la primera vez."
|
||||
WEBUI_PORT="${WEBUI_PORT:-3000}"
|
||||
DEFAULT_MODEL="${DEFAULT_MODEL:-llama3.2:3b}"
|
||||
|
||||
# Esperar a que Ollama responda
|
||||
echo " Esperando a que Ollama arranque..."
|
||||
MAX_WAIT=60
|
||||
WAITED=0
|
||||
until docker exec d0a1-ollama ollama ps &>/dev/null; do
|
||||
sleep 2
|
||||
WAITED=$((WAITED + 2))
|
||||
if [ "$WAITED" -ge "$MAX_WAIT" ]; then
|
||||
echo -e "${RED}✗ Ollama no arrancó en ${MAX_WAIT}s. Revisa los logs:${NC}"
|
||||
echo " docker logs d0a1-ollama"
|
||||
exit 1
|
||||
fi
|
||||
# --- Memoria del sistema (Linux + macOS) -------------------------------------
|
||||
|
||||
total_ram_gb() {
|
||||
case "$(uname -s)" in
|
||||
Linux)
|
||||
awk '/MemTotal/ {printf "%d\n", $2/1024/1024}' /proc/meminfo
|
||||
;;
|
||||
Darwin)
|
||||
sysctl -n hw.memsize | awk '{printf "%d\n", $1/1024/1024/1024}'
|
||||
;;
|
||||
*)
|
||||
echo "0"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
RAM_GB=$(total_ram_gb)
|
||||
|
||||
# --- Arranque ----------------------------------------------------------------
|
||||
|
||||
info "Levantando servicios (esto puede tardar unos segundos)..."
|
||||
docker compose up -d
|
||||
|
||||
info "Esperando a que Ollama este listo..."
|
||||
TIMEOUT=60
|
||||
ELAPSED=0
|
||||
until docker exec d0a1-ollama ollama list >/dev/null 2>&1; do
|
||||
sleep 2
|
||||
ELAPSED=$((ELAPSED + 2))
|
||||
if [ "$ELAPSED" -ge "$TIMEOUT" ]; then
|
||||
err "Ollama no arranco en ${TIMEOUT}s. Revisa 'docker compose logs ollama'."
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
|
||||
docker exec d0a1-ollama ollama pull llama3.2:3b
|
||||
# --- Modelo por defecto ------------------------------------------------------
|
||||
|
||||
# ── Listo ────────────────────────────────────
|
||||
echo ""
|
||||
echo -e "${BOLD}${GREEN}¡Listo! Tu IA local está corriendo.${NC}"
|
||||
echo ""
|
||||
echo -e " ${BOLD}Abre tu navegador:${NC} ${CYAN}http://localhost:3000${NC}"
|
||||
echo ""
|
||||
echo " No necesitas cuenta ni API key. Empieza a chatear."
|
||||
echo ""
|
||||
echo -e " ${BOLD}Modelos adicionales (opcionales):${NC}"
|
||||
echo " docker exec d0a1-ollama ollama pull qwen2.5:7b # Mejor en español (5 GB RAM)"
|
||||
echo " docker exec d0a1-ollama ollama pull llama3.1:8b # Más calidad (6 GB RAM)"
|
||||
echo " docker exec d0a1-ollama ollama pull codellama:7b # Para código (5 GB RAM)"
|
||||
echo ""
|
||||
echo -e " ${BOLD}Comandos útiles:${NC}"
|
||||
echo " docker compose -f $COMPOSE_FILE logs -f # Ver logs"
|
||||
echo " docker compose -f $COMPOSE_FILE down # Parar todo"
|
||||
echo " docker compose -f $COMPOSE_FILE down -v # Borrar todo (incluidos datos)"
|
||||
echo ""
|
||||
echo -e " ${BOLD}¿Quieres más?${NC} Despliega el stack completo en un VPS:"
|
||||
echo " ${CYAN}https://d0a1.es/vps${NC}"
|
||||
echo ""
|
||||
echo -e "${BOLD}${CYAN}═══════════════════════════════════════════${NC}"
|
||||
if ! docker exec d0a1-ollama ollama list | grep -q "$DEFAULT_MODEL"; then
|
||||
info "Descargando modelo por defecto: $DEFAULT_MODEL"
|
||||
if [ "$RAM_GB" -gt 0 ] && [ "$RAM_GB" -lt 8 ]; then
|
||||
warn "Detectados ${RAM_GB} GB de RAM. Para este modelo se recomiendan 8 GB."
|
||||
warn "Si falla la carga, prueba con 'docker exec d0a1-ollama ollama pull llama3.2:1b'."
|
||||
fi
|
||||
docker exec d0a1-ollama ollama pull "$DEFAULT_MODEL"
|
||||
else
|
||||
info "Modelo $DEFAULT_MODEL ya esta descargado."
|
||||
fi
|
||||
|
||||
# --- Resultado ---------------------------------------------------------------
|
||||
|
||||
printf "\n"
|
||||
info "d0a1 quickstart listo!"
|
||||
printf "\n"
|
||||
printf " %bOpen WebUI:%b http://localhost:%s\n" "$BOLD" "$RESET" "$WEBUI_PORT"
|
||||
printf " %bOllama:%b http://localhost:%s\n" "$BOLD" "$RESET" "${OLLAMA_PORT:-11434}"
|
||||
printf "\n"
|
||||
info "Comandos utiles:"
|
||||
printf " docker compose logs -f # logs en tiempo real\n"
|
||||
printf " docker compose down # parar todo\n"
|
||||
printf " docker exec d0a1-ollama ollama pull <modelo> # anadir modelos\n"
|
||||
printf "\n"
|
||||
|
||||
Reference in New Issue
Block a user