Instalación
Requisitos
- Docker Desktop (Mac/Linux/Windows)
- Node.js v20+ (via NVM recomendado)
- pnpm v10+
- Git
Instalación en desarrollo
1. Clonar el repositorio
git clone https://github.com/ncarriquiry/kuatia.git
cd kuatia
2. Configurar NVM y Node
# Instalar NVM
brew install nvm
# Configurar en ~/.bash_profile
export NVM_DIR="$HOME/.nvm"
[ -s "/usr/local/opt/nvm/nvm.sh" ] && \. "/usr/local/opt/nvm/nvm.sh"
# Instalar Node 20
nvm install 20 && nvm use 20
3. Instalar herramientas
npm install -g pnpm
pnpm add -g @nestjs/cli
4. Levantar infraestructura Docker
docker compose up -d
Servicios levantados:
| Servicio | Puerto | Credenciales |
|---|---|---|
| PostgreSQL | 5432 | dev / dev |
| MongoDB | 27017 | dev / dev |
| MinIO | 9000 (S3 API) / 9002 (consola) | minioadmin / minioadmin |
| Redis | 6379 | — |
| Keycloak | 8080 | admin / admin |
| Typesense | 8108 | kuatia-dev-key |
5. Configurar variables de ambiente
cp api/.env.example api/.env
# Editar api/.env con los valores de desarrollo
6. Levantar la API
cd api && pnpm install && pnpm run start:dev
# API disponible en http://localhost:3000
7. Levantar el frontend
cd frontend && pnpm install && pnpm dev
# Frontend disponible en http://localhost:5173
8. Primer login
- Ir a http://localhost:5173
- Email:
super_admin@kuatia.test - Password:
test1234
info
El bootstrap crea automáticamente los usuarios de prueba al arrancar
en modo development.
Con observabilidad
# Levanta todo: Kuatia + SigNoz + Grafana
pnpm obs:up
# URLs adicionales:
# SigNoz: http://localhost:3301
# Grafana: http://localhost:3030