Quickstart — Tu primera sesión con NidoX
Tiempo total estimado: 5-7 minutos. Aplica a NidoX v2.1.7+.
Este documento te lleva de cero a "estás guardando memoria persistente
con tu IA favorita" en 7 pasos. Si te trabás en alguno, mirá la
FAQ o escribinos a
gianni.risieri@gmail.com.
Los 7 pasos
- Descargar e instalar NidoX (la app)
- Activar tu licencia
- Crear tu primer proyecto
- Iniciar el server local
- Instalar la extensión Chrome
- Abrir tu IA y hacer la primera sesión
- Cerrar la sesión y verificar que se guardó
Paso 1 ~1 min
Descargar e instalar NidoX
- Andá a github.com/giannirisieri-collab/nidox-releases/releases.
- Descargá el ZIP de Windows:
NidoX-2.1.7-windows-x64.zip.
- Extraelo en cualquier carpeta (ej.
C:\Apps\NidoX\).
- Hacé doble clic en
NidoX.exe.
Si Windows muestra "Aplicación no reconocida": hacé clic en
"Más información" → "Ejecutar de todas formas". Eso pasa solo la primera
vez. Estamos firmando los binarios — desde la próxima versión no aparece
el aviso.
Paso 2 ~30 seg
Activar tu licencia
Cuando abrís NidoX por primera vez te pide un código:
- Pegá el código que recibiste por email (formato
NDX-XXXX-XXXX-XXXXXXXX).
- Click en Activar.
Listo: ves el mensaje "Licencia válida" y arranca la
ventana principal con tu nombre arriba.
Si perdiste el código andá a recover.html.
Paso 3 ~1 min
Crear tu primer proyecto
Aparece el modal "¿En qué vas a trabajar hoy?":
- Click en + Crear proyecto nuevo.
- Escribí un nombre descriptivo:
tesis-doctorado,
app-fitness, guion-novela, lo que sea. Sin
espacios o con guiones — el nombre se usa como carpeta en disco.
- Click en Crear.
Tu proyecto aparece como activo. La carpeta física vive en
C:\Users\<tu-usuario>\.nidox\<nombre-proyecto>\.
Paso 4 ~10 seg
Iniciar el server local
En la ventana principal de NidoX vas a ver un botón verde grande:
- Click en ▶ INICIAR NIDOX.
El botón cambia a rojo (⏹ DETENER NIDOX) y el indicador
de status pasa a verde con el mensaje "Activo en localhost:7474".
Eso significa que la app está lista para que la extensión Chrome se
conecte.
Dejá la ventana abierta mientras estés trabajando con
IAs. Podés minimizarla pero no cerrarla — si la cerrás, el server se
apaga y la extensión queda desconectada.
Paso 5 ~1 min
Instalar la extensión Chrome
- Abrí Chrome (o Edge, Brave, Arc — cualquier navegador Chromium).
- Andá a Chrome Web Store: NidoX
(o buscá "NidoX" en el store).
- Click en Añadir a Chrome → Añadir extensión.
La extensión queda instalada y aparece su ícono morado en la barra de
Chrome. La primera vez que se conecta a NidoX, te aparece un diálogo en la
app preguntando "¿Permitir esta extensión?" — click en SÍ.
Paso 6 ~1 min
Abrir tu IA y hacer la primera sesión
Abrí una pestaña nueva con la IA que prefieras:
A los ~2 segundos de cargar la página vas a ver:
- Un botón flotante morado abajo a la izquierda:
"⏹ Terminar sesión y guardar".
- Un modal centrado preguntando "¿En qué proyecto
trabajás hoy?". Elegí el proyecto que creaste y click en
Trabajar en este proyecto.
Si tu proyecto no tenía memoria previa, la IA no recibe contexto extra.
Si ya habías guardado sesiones, NidoX inyecta automáticamente la Memoria
Maestra del proyecto.
Ahora chateá con la IA como siempre. Tomate al menos
unos minutos de conversación real para que el resumen del paso siguiente
tenga contenido.
Paso 7 ~1-2 min
Cerrar la sesión y verificar que se guardó
- Cuando termines de chatear, click en ⏹ Terminar sesión y
guardar (botón morado abajo a la izquierda).
- Ves un toast: "NidoX: pidiendo resumen y memoria a la IA...".
- NidoX inyecta automáticamente un prompt largo en el input de la IA
y lo envía. La IA responde con un resumen estructurado.
- Cuando la respuesta termina (toma 30-60 segundos), aparece un modal
con dos pestañas: Resumen de la sesión y
Memoria maestra actualizada. Revisá ambas — si algo
está raro podés editarlo en el textarea.
- Click en 💾 Guardar.
¡Listo! Toast verde: "NidoX: guardado en
'tu-proyecto' — memoria maestra actualizada". La conversación quedó
archivada localmente y tu Memoria Maestra refleja lo nuevo.
Verificar en disco (opcional)
Si querés ver los archivos físicos:
cd C:\Users\<tu-usuario>\.nidox\<tu-proyecto>
dir
# Vas a ver:
# - knowledge_index.json ← contador de sesiones, aprendizajes acumulados
# - memoria_maestra.md ← el documento vivo (lo que la IA reescribe)
# - sesion_2026-04-27_*.md ← resumen legible de la sesión que cerraste
# - session_*.json ← data cruda
# - backup/ ← versiones previas por si querés rollback
Próximas sesiones
De acá en más, el flujo es más corto:
- Abrir NidoX (si no está corriendo). Click en INICIAR NIDOX.
- Abrir pestaña con tu IA. NidoX inyecta automáticamente el contexto del
proyecto activo — la IA arranca sabiendo todo lo que charlaron
antes.
- Conversar.
- Click en "⏹ Terminar sesión y guardar" cuando termines.
Tiempo total por sesión: 5 segundos arriba + 5 segundos
abajo = 10 segundos de overhead para tener memoria persistente. La IA
arranca actualizada, no como si te estuvieras presentando de cero
cada vez.
¿Qué hacer si algo falla?
Tres archivos te dan señal rápida cuando hay problemas:
~/.nidox/.errors.log — tracebacks de errores (rotativo).
~/.nidox/.analytics.jsonl — eventos de uso (sesiones
guardadas, fallos detectados).
- Console de Chrome (F12 en una pestaña de IA) — errores en la
extensión.
Si necesitás ayuda mandanos un email con esos archivos adjuntos o pegando
las últimas 50 líneas. Email: gianni.risieri@gmail.com.
Quickstart actualizado a NidoX v2.1.7. Última revisión 2026-04-27.
¿Recomendás cambios a este documento? Mandanos sugerencias por email.