A.L.I.C.E. Frontend

Frontend web (Next.js) del asistente LLM A.L.I.C.E. — chat, tema claro/oscuro y splash de carga.
Explorar repositorio »

Ver código · Reportar bug · Pedir feature

Tabla de contenidos

1. About the project
2. Built with
3. Important notices
4. Getting started
   • Prerequisites
   • Installation
   • Available scripts
5. Environments
6. Deployment
7. Contributing
   • Top contributors
8. Contact

About the project

A.L.I.C.E. (frontend) es la interfaz de chat del asistente LLM.

Incluye:

• Chat con streaming hacia el backend Flask.
• Sidebar de conversaciones, tema claro/oscuro y wordmark metálico.
• Splash de carga sincronizado con el health/warmup del backend.
• Micrófono del navegador + TTS del cliente (sin STT/TTS en el server).

(back to top)

Built with

• 
• 
• 
• 
• 
• 

(back to top)

Important notices

Note

No necesitas instalar nada global aparte de Node.js.

Usa npm run dev para levantar el servidor local.

Important

Este repo es el frontend. Para chatear necesitas el backend de A.L.I.C.E. corriendo y configurar NEXT_PUBLIC_API_URL en .env.local.

(back to top)

Getting started

Prerequisites

• Node.js (recomendado: LTS)
• npm
• Backend A.L.I.C.E. en http://localhost:5000 (o la URL que configures)

Installation

1. Clonar el repositorio

git clone https://github.com/hexed-AAL1X/A.L.I.C.E-front.git
cd A.L.I.C.E-front

2. Instalar dependencias

npm install

3. Configurar entorno

cp .env.local.example .env.local
# o crea .env.local con:
# NEXT_PUBLIC_API_URL=http://localhost:5000

4. Ejecutar en modo desarrollo

npm run dev

5. Abrir en el navegador

• http://localhost:3000/

Available scripts

npm run dev      # next dev
npm run build    # build producción
npm run start    # next start
npm run lint     # eslint

(back to top)

Environments

Variables en .env.local (Next.js):

Variable	Descripción	Default
NEXT_PUBLIC_API_URL	URL base del backend Flask	http://localhost:5000

El front llama, entre otros, a /api/health, /api/warmup y /api/chat/stream.

(back to top)

Deployment

Render (Web Service)

• Root directory: frontend (si el monorepo incluye más carpetas) o la raíz de este repo
• Build command:

npm ci && npm run build

• Start command:

npm run start -- -p $PORT

• Env:

NEXT_PUBLIC_API_URL=https://TU-BACKEND.onrender.com

Note

En el free tier de Render el servicio duerme tras inactividad; el splash del front espera a /api/health.

(back to top)

Contributing

Contribuciones bienvenidas.

1. Fork del proyecto
2. Crear una rama (git checkout -b feature/nueva-feature)
3. Commit (git commit -m "Add: ...")
4. Push (git push origin feature/nueva-feature)
5. Pull Request

Top contributors

Diego Melendez @ShoterBroXD

SebasTM502 @SebasTM502

(back to top)

Contact

(back to top)