CasosHerramientasEN

PocketRAG: RAG Portfolio en Hosting PHP Compartido

Portfolio interactivo con IA (PocketRAG) que responde preguntas sobre mi carrera usando conocimiento real — sobre hosting compartido que no puede ejecutar Python, Docker ni una base de datos vectorial.

Cliente: Proyecto personal
RAGBM25PHPGroqHostGatorPocketRAG

El objetivo

Desplegar un portfolio interactivo con IA que responda preguntas sobre mi carrera usando conocimiento real — en hosting compartido que no puede ejecutar apps Python, Docker ni una base de datos vectorial.

Restricciones

  • HostGator shared hosting: PHP + Apache únicamente; sin Passenger Python, sin paquetes Composer para retrieval
  • HTTPS saliente disponible a Groq; secretos deben vivir fuera del docroot
  • El corpus es pequeño (~archivos markdown de conocimiento), por lo que los embeddings añaden costo sin beneficio claro

Arquitectura

Frontend estático — UI de chat HTML/CSS/JS con rutas bilingües EN/ES

Retrieval — BM25 sobre knowledge/*.md con expansión de sinónimos; atajos de flujo para rutas reclutador/builder

Generación — Groq (llama-3.3-70b-versatile) via PHP cURL plano

Hardening — rate limits por IP, clamps de mensajes/historial, lista CORS, secretos en ~/private/

Voz opcional — endpoint de token LiveKit únicamente; el agente en tiempo real corre en otro lugar

Resultado

Un stack sin dependencias que permanece mantenible en hosting commodity, reconstruye el índice en cada solicitud y mantiene la experiencia de “chat portfolio” sin bloquear el SEO detrás de un SPA vacío — el contenido profesional también vive en flujos HTML estáticos.