Pon en marcha Sentidiño BI en tu ordenador
Esta guía te lleva de cero a tener el dashboard funcionando, paso a paso y sin necesitar conocimientos técnicos. Tiempo estimado: 15–20 minutos. La aplicación se instala en tu propio PC: tus datos y tus claves nunca salen de él.
Qué vas a necesitar
| Requisito | Detalle |
|---|---|
| Un ordenador | Windows 10/11, Mac o Linux, con conexión a internet. |
| Acceso a tu Odoo | La dirección web de tu Odoo (por ejemplo https://tuempresa.odoo.com) y un usuario con el que puedas entrar. Crearemos una "clave API" desde él en el paso 4. |
| Una cuenta de Claude (Anthropic) | Es la inteligencia artificial que traduce tus preguntas en gráficas. Se crea gratis en console.anthropic.com, aunque el uso de la API requiere añadir un método de pago (el consumo típico de este dashboard es de céntimos). |
| El archivo de la aplicación | El fichero sentidino-bi.zip que te han facilitado. |
Tranquilidad ante todoLa aplicación solo lee datos de Odoo: por diseño no puede modificar, crear ni borrar nada. Y tus claves se guardan únicamente en tu ordenador, protegidas por una contraseña que crearás tú.
1Instalar Node.js
¿Qué es? Node.js es el "motor" gratuito que permite que la aplicación funcione en tu ordenador, igual que un coche necesita motor para arrancar. Se instala una sola vez y no tendrás que volver a tocarlo.
WINDOWSInstalación en Windows
- Abre tu navegador y entra en nodejs.org.
- Pulsa el botón verde grande que pone LTS (significa "versión estable recomendada"). Se descargará un archivo que termina en
.msi. - Abre el archivo descargado (normalmente está en tu carpeta Descargas) haciendo doble clic.
- En el instalador, pulsa Next en todas las pantallas sin cambiar nada, acepta la licencia, y al final Install. Si Windows pide permiso ("¿Quieres permitir que esta aplicación haga cambios?"), responde Sí.
- Cuando termine, pulsa Finish. Ya está.
- Comprobación (opcional pero recomendada): pulsa las teclas Windows + R, escribe
cmdy pulsa Enter. En la ventana negra que se abre, escribenode -vy pulsa Enter. Si aparece algo comov22.11.0, perfecto. Cierra la ventana.
MACInstalación en Mac
- Entra en nodejs.org y pulsa el botón verde LTS. Se descargará un archivo
.pkg. - Ábrelo con doble clic y sigue el instalador pulsando Continuar → Aceptar → Instalar. Te pedirá tu contraseña del Mac.
- Comprobación: abre la aplicación Terminal (búscala con ⌘ + Espacio escribiendo "Terminal"), escribe
node -vy pulsa Enter. Debe responder con un número de versión.
LINUXInstalación en Linux (Ubuntu / Debian y derivados)
- Abre la aplicación Terminal (tecla Ctrl + Alt + T en la mayoría de distribuciones).
- Copia y pega esta línea y pulsa Enter (te pedirá tu contraseña; al escribirla no se ve, es normal):
sudo apt update && sudo apt install -y nodejs npm - Comprobación: escribe
node -vy pulsa Enter. Si tu distribución trae una versión antigua (menor que v18), instala la versión moderna con:curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt install -y nodejs
2Descargar y descomprimir la aplicación
- Guarda el archivo
sentidino-bi.zipen tu ordenador. - Descomprímelo en una carpeta estable donde vaya a quedarse, por ejemplo Documentos. En Windows: clic derecho sobre el zip → Extraer todo… → elige Documentos → Extraer. En Mac: doble clic sobre el zip. En Linux: clic derecho → Extraer aquí.
- Comprueba que existe la carpeta sentidino-bi con archivos dentro (verás
install,start, carpetaspublicysrc…).
Muy importanteNo ejecutes nada desde dentro del programa de descompresión (WinRAR, 7-Zip…): primero extrae, después entra en la carpeta extraída con el Explorador de archivos normal.
3Instalar la aplicación
WINDOWS
- Entra en la carpeta sentidino-bi y haz doble clic en el archivo
install(Windows lo describe como "Archivo por lotes"). - Si aparece una pantalla azul que dice "Windows protegió tu equipo", pulsa Más información y después Ejecutar de todas formas. Es el aviso estándar para programas descargados de internet.
- Se abrirá una ventana negra que instala lo necesario (tarda alrededor de un minuto, necesita internet).
- Te preguntará: "¿Quieres que Sentidiño BI arranque automáticamente al encender el PC?". Pulsa la tecla S para sí o N para no (recomendado: S, así siempre estará lista).
- Al terminar, se abrirá tu navegador solo con el asistente de configuración. ¡Sigue en el paso 5 de esta guía!
MAC LINUX
- Abre la Terminal.
- Escribe
cd(con un espacio detrás) y arrastra la carpeta sentidino-bi desde el Finder/Archivos hasta la ventana de Terminal — se escribirá la ruta sola. Pulsa Enter. - Copia, pega y ejecuta:
chmod +x install.sh start.sh && ./install.sh - Responde s o n a la pregunta del arranque automático, y al terminar se abrirá el navegador con el asistente.
4Preparar tus dos claves (antes del asistente)
El asistente te pedirá dos "llaves" para conectar con tus datos. Prepáralas ahora y tenlas copiadas en un bloc de notas:
La clave API de Odoo
- Entra en tu Odoo con tu navegador, como siempre.
- Pulsa sobre tu foto o iniciales (arriba a la derecha) y elige Mi perfil (o "Preferencias").
- Ve a la pestaña Seguridad de la cuenta.
- Pulsa Nueva clave API. Odoo puede pedirte tu contraseña para confirmar.
- Ponle un nombre reconocible (por ejemplo "Sentidiño BI"), y en duración elige la más larga o "persistente" si te lo pregunta.
- Copia la clave inmediatamente y guárdala en tu bloc de notas: solo se muestra una vez.
- Apunta también estos dos datos: la dirección de tu Odoo (lo que ves en el navegador, tipo
https://tuempresa.odoo.com) y el nombre de la base de datos (en Odoo Online suele ser la primera palabra de esa dirección, ej.tuempresa).
Consejo de seguridad (opcional pero muy recomendable)En lugar de tu usuario administrador, pide a tu asesor de Odoo que cree un usuario específico (ej. api-dashboard@tuempresa.es) con permisos de solo lectura sobre Ventas, Contabilidad y CRM, y genera la clave desde ese usuario. Así, aunque la clave se filtrase, nadie podría tocar nada.
La clave de Claude (Anthropic)
- Entra en console.anthropic.com y crea una cuenta (o inicia sesión).
- Si es tu primera vez, entra en Billing (facturación) y añade un método de pago con un pequeño crédito (5 $ dan para meses de uso normal del dashboard).
- En el menú, entra en API Keys y pulsa Create Key.
- Ponle nombre ("Sentidiño BI"), créala y cópiala a tu bloc de notas. Empieza por
sk-ant-…y también se muestra una sola vez.
5El asistente de configuración (primera vez)
Al arrancar por primera vez, el navegador muestra un asistente de 3 pantallas. Nada se guarda hasta que las dos conexiones están comprobadas, así que es imposible dejarlo "a medias mal".
- Crea tu contraseña de configuración (mínimo 8 caracteres, escríbela dos veces). Protege la pantalla donde viven tus claves. Si algún día la olvidas, se recupera con un código enviado al correo de tu usuario de Odoo.
- Conecta con Odoo: rellena la dirección, la base de datos, tu usuario (el correo con el que entras a Odoo) y la clave API que copiaste. Pulsa Probar conexión y continuar — verás un mensaje verde confirmando la versión de tu Odoo.
- Valida tu clave de Claude: pégala y pulsa Validar y terminar la instalación. La aplicación hace una llamada de prueba real y, si es correcta, guarda todo y te lleva al dashboard.
¡Ya está!A partir de aquí, consulta la Guía de funcionalidades para sacarle todo el partido.
6Uso diario
| Quiero… | Cómo |
|---|---|
| Abrir el dashboard | Si activaste el autoarranque, ya está en marcha: abre el navegador y entra en http://localhost:3000 (guárdalo en favoritos). Si no, haz doble clic en start dentro de la carpeta (Mac/Linux: ./start.sh). |
| Saber si está funcionando | En Windows verás una ventana minimizada llamada "Sentidiño BI" en la barra de tareas. En el dashboard, arriba a la derecha, un óvalo verde dice "Conectado a Odoo…". |
| Cerrarla del todo | Cierra esa ventana minimizada "Sentidiño BI" (la X). Cerrar solo la pestaña del navegador no la apaga (y no pasa nada por dejarla encendida). |
7Actualizar la aplicación
- Cierra la ventana "Sentidiño BI" de la barra de tareas.
- Extrae el nuevo
sentidino-bi.zipsobre la misma carpeta, aceptando reemplazar los archivos. Tu configuración, contraseña y favoritos no se tocan (viven en la carpetadata, que las actualizaciones nunca incluyen). - Doble clic en
starty, en el navegador, pulsa Ctrl + F5 una vez (recarga limpia). - Comprueba el número de versión junto a "Conectado a Odoo", arriba a la derecha: debe coincidir con el de la actualización.
Solución de problemas
La ventana negra se abre y se cierra al instanteCasi siempre significa que Node.js no está instalado (vuelve al paso 1). Para ver el mensaje exacto: entra en la carpeta, haz clic en la barra de direcciones del Explorador, escribe
cmd y pulsa Enter; en la ventana negra escribe install.bat — el error quedará en pantalla.El navegador dice "no se puede acceder a localhost:3000"La aplicación no está arrancada: doble clic en
start. Si ya lo hiciste y sigue igual, quizá hay otra copia usando el puerto: reinicia el ordenador y vuelve a probar."Sin conexión con Odoo" en rojoEntra en Configuración (pestaña con candado, arriba a la derecha del dashboard), revisa la dirección, la base de datos, el usuario y la clave, y pulsa Probar y guardar conexiones. El mensaje de error te dirá qué dato falla.
El PyG o los informes salen a ceroComprueba dos cosas: que en el selector de empresas (arriba, junto al estado de conexión) está elegida la empresa correcta, y que las facturas en Odoo están publicadas (no en borrador). Las alertas amarillas del informe te orientan sobre la causa exacta.
He olvidado la contraseña de ConfiguraciónEn la pantalla de contraseña, pulsa "¿Olvidaste la contraseña?": recibirás un código de 6 dígitos en el correo de tu usuario de Odoo (si tu usuario no puede enviar correos, el código aparece en la ventana negra "Sentidiño BI" de tu propio PC).
¿Ninguna de estas es tu situación?Haz una captura de pantalla del mensaje exacto que ves y envíasela a tu soporte: con el texto literal, la solución suele ser inmediata.
Pon en marcha Sentidiño BI en tu ordenador
Esta guía te lleva de cero a tener el dashboard funcionando, paso a paso y sin necesitar conocimientos técnicos. Tiempo estimado: 15–20 minutos. La aplicación se instala en tu propio PC: tus datos y tus claves nunca salen de él.
Qué vas a necesitar
| Requisito | Detalle |
|---|---|
| Un ordenador | Windows 10/11, Mac o Linux, con conexión a internet. |
| Acceso a tu Odoo | La dirección web de tu Odoo (por ejemplo https://tuempresa.odoo.com) y un usuario con el que puedas entrar. Crearemos una "clave API" desde él en el paso 4. |
| Una cuenta de Claude (Anthropic) | Es la inteligencia artificial que traduce tus preguntas en gráficas. Se crea gratis en console.anthropic.com, aunque el uso de la API requiere añadir un método de pago (el consumo típico de este dashboard es de céntimos). |
| El archivo de la aplicación | El fichero sentidino-bi.zip que te han facilitado. |
Tranquilidad ante todoLa aplicación solo lee datos de Odoo: por diseño no puede modificar, crear ni borrar nada. Y tus claves se guardan únicamente en tu ordenador, protegidas por una contraseña que crearás tú.
1Instalar Node.js
¿Qué es? Node.js es el "motor" gratuito que permite que la aplicación funcione en tu ordenador, igual que un coche necesita motor para arrancar. Se instala una sola vez y no tendrás que volver a tocarlo.
WINDOWSInstalación en Windows
- Abre tu navegador y entra en nodejs.org.
- Pulsa el botón verde grande que pone LTS (significa "versión estable recomendada"). Se descargará un archivo que termina en
.msi. - Abre el archivo descargado (normalmente está en tu carpeta Descargas) haciendo doble clic.
- En el instalador, pulsa Next en todas las pantallas sin cambiar nada, acepta la licencia, y al final Install. Si Windows pide permiso ("¿Quieres permitir que esta aplicación haga cambios?"), responde Sí.
- Cuando termine, pulsa Finish. Ya está.
- Comprobación (opcional pero recomendada): pulsa las teclas Windows + R, escribe
cmdy pulsa Enter. En la ventana negra que se abre, escribenode -vy pulsa Enter. Si aparece algo comov22.11.0, perfecto. Cierra la ventana.
MACInstalación en Mac
- Entra en nodejs.org y pulsa el botón verde LTS. Se descargará un archivo
.pkg. - Ábrelo con doble clic y sigue el instalador pulsando Continuar → Aceptar → Instalar. Te pedirá tu contraseña del Mac.
- Comprobación: abre la aplicación Terminal (búscala con ⌘ + Espacio escribiendo "Terminal"), escribe
node -vy pulsa Enter. Debe responder con un número de versión.
LINUXInstalación en Linux (Ubuntu / Debian y derivados)
- Abre la aplicación Terminal (tecla Ctrl + Alt + T en la mayoría de distribuciones).
- Copia y pega esta línea y pulsa Enter (te pedirá tu contraseña; al escribirla no se ve, es normal):
sudo apt update && sudo apt install -y nodejs npm - Comprobación: escribe
node -vy pulsa Enter. Si tu distribución trae una versión antigua (menor que v18), instala la versión moderna con:curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt install -y nodejs
2Descargar y descomprimir la aplicación
- Guarda el archivo
sentidino-bi.zipen tu ordenador. - Descomprímelo en una carpeta estable donde vaya a quedarse, por ejemplo Documentos. En Windows: clic derecho sobre el zip → Extraer todo… → elige Documentos → Extraer. En Mac: doble clic sobre el zip. En Linux: clic derecho → Extraer aquí.
- Comprueba que existe la carpeta sentidino-bi con archivos dentro (verás
install,start, carpetaspublicysrc…).
Muy importanteNo ejecutes nada desde dentro del programa de descompresión (WinRAR, 7-Zip…): primero extrae, después entra en la carpeta extraída con el Explorador de archivos normal.
3Instalar la aplicación
WINDOWS
- Entra en la carpeta sentidino-bi y haz doble clic en el archivo
install(Windows lo describe como "Archivo por lotes"). - Si aparece una pantalla azul que dice "Windows protegió tu equipo", pulsa Más información y después Ejecutar de todas formas. Es el aviso estándar para programas descargados de internet.
- Se abrirá una ventana negra que instala lo necesario (tarda alrededor de un minuto, necesita internet).
- Te preguntará: "¿Quieres que Sentidiño BI arranque automáticamente al encender el PC?". Pulsa la tecla S para sí o N para no (recomendado: S, así siempre estará lista).
- Al terminar, se abrirá tu navegador solo con el asistente de configuración. ¡Sigue en el paso 5 de esta guía!
MAC LINUX
- Abre la Terminal.
- Escribe
cd(con un espacio detrás) y arrastra la carpeta sentidino-bi desde el Finder/Archivos hasta la ventana de Terminal — se escribirá la ruta sola. Pulsa Enter. - Copia, pega y ejecuta:
chmod +x install.sh start.sh && ./install.sh - Responde s o n a la pregunta del arranque automático, y al terminar se abrirá el navegador con el asistente.
4Preparar tus dos claves (antes del asistente)
El asistente te pedirá dos "llaves" para conectar con tus datos. Prepáralas ahora y tenlas copiadas en un bloc de notas:
La clave API de Odoo
- Entra en tu Odoo con tu navegador, como siempre.
- Pulsa sobre tu foto o iniciales (arriba a la derecha) y elige Mi perfil (o "Preferencias").
- Ve a la pestaña Seguridad de la cuenta.
- Pulsa Nueva clave API. Odoo puede pedirte tu contraseña para confirmar.
- Ponle un nombre reconocible (por ejemplo "Sentidiño BI"), y en duración elige la más larga o "persistente" si te lo pregunta.
- Copia la clave inmediatamente y guárdala en tu bloc de notas: solo se muestra una vez.
- Apunta también estos dos datos: la dirección de tu Odoo (lo que ves en el navegador, tipo
https://tuempresa.odoo.com) y el nombre de la base de datos (en Odoo Online suele ser la primera palabra de esa dirección, ej.tuempresa).
Consejo de seguridad (opcional pero muy recomendable)En lugar de tu usuario administrador, pide a tu asesor de Odoo que cree un usuario específico (ej. api-dashboard@tuempresa.es) con permisos de solo lectura sobre Ventas, Contabilidad y CRM, y genera la clave desde ese usuario. Así, aunque la clave se filtrase, nadie podría tocar nada.
La clave de Claude (Anthropic)
- Entra en console.anthropic.com y crea una cuenta (o inicia sesión).
- Si es tu primera vez, entra en Billing (facturación) y añade un método de pago con un pequeño crédito (5 $ dan para meses de uso normal del dashboard).
- En el menú, entra en API Keys y pulsa Create Key.
- Ponle nombre ("Sentidiño BI"), créala y cópiala a tu bloc de notas. Empieza por
sk-ant-…y también se muestra una sola vez.
5El asistente de configuración (primera vez)
Al arrancar por primera vez, el navegador muestra un asistente de 3 pantallas. Nada se guarda hasta que las dos conexiones están comprobadas, así que es imposible dejarlo "a medias mal".
- Crea tu contraseña de configuración (mínimo 8 caracteres, escríbela dos veces). Protege la pantalla donde viven tus claves. Si algún día la olvidas, se recupera con un código enviado al correo de tu usuario de Odoo.
- Conecta con Odoo: rellena la dirección, la base de datos, tu usuario (el correo con el que entras a Odoo) y la clave API que copiaste. Pulsa Probar conexión y continuar — verás un mensaje verde confirmando la versión de tu Odoo.
- Valida tu clave de Claude: pégala y pulsa Validar y terminar la instalación. La aplicación hace una llamada de prueba real y, si es correcta, guarda todo y te lleva al dashboard.
¡Ya está!A partir de aquí, consulta la Guía de funcionalidades para sacarle todo el partido.
6Uso diario
| Quiero… | Cómo |
|---|---|
| Abrir el dashboard | Si activaste el autoarranque, ya está en marcha: abre el navegador y entra en http://localhost:3000 (guárdalo en favoritos). Si no, haz doble clic en start dentro de la carpeta (Mac/Linux: ./start.sh). |
| Saber si está funcionando | En Windows verás una ventana minimizada llamada "Sentidiño BI" en la barra de tareas. En el dashboard, arriba a la derecha, un óvalo verde dice "Conectado a Odoo…". |
| Cerrarla del todo | Cierra esa ventana minimizada "Sentidiño BI" (la X). Cerrar solo la pestaña del navegador no la apaga (y no pasa nada por dejarla encendida). |
7Actualizar la aplicación
- Cierra la ventana "Sentidiño BI" de la barra de tareas.
- Extrae el nuevo
sentidino-bi.zipsobre la misma carpeta, aceptando reemplazar los archivos. Tu configuración, contraseña y favoritos no se tocan (viven en la carpetadata, que las actualizaciones nunca incluyen). - Doble clic en
starty, en el navegador, pulsa Ctrl + F5 una vez (recarga limpia). - Comprueba el número de versión junto a "Conectado a Odoo", arriba a la derecha: debe coincidir con el de la actualización.
Solución de problemas
La ventana negra se abre y se cierra al instanteCasi siempre significa que Node.js no está instalado (vuelve al paso 1). Para ver el mensaje exacto: entra en la carpeta, haz clic en la barra de direcciones del Explorador, escribe
cmd y pulsa Enter; en la ventana negra escribe install.bat — el error quedará en pantalla.El navegador dice "no se puede acceder a localhost:3000"La aplicación no está arrancada: doble clic en
start. Si ya lo hiciste y sigue igual, quizá hay otra copia usando el puerto: reinicia el ordenador y vuelve a probar."Sin conexión con Odoo" en rojoEntra en Configuración (pestaña con candado, arriba a la derecha del dashboard), revisa la dirección, la base de datos, el usuario y la clave, y pulsa Probar y guardar conexiones. El mensaje de error te dirá qué dato falla.
El PyG o los informes salen a ceroComprueba dos cosas: que en el selector de empresas (arriba, junto al estado de conexión) está elegida la empresa correcta, y que las facturas en Odoo están publicadas (no en borrador). Las alertas amarillas del informe te orientan sobre la causa exacta.
He olvidado la contraseña de ConfiguraciónEn la pantalla de contraseña, pulsa "¿Olvidaste la contraseña?": recibirás un código de 6 dígitos en el correo de tu usuario de Odoo (si tu usuario no puede enviar correos, el código aparece en la ventana negra "Sentidiño BI" de tu propio PC).
¿Ninguna de estas es tu situación?Haz una captura de pantalla del mensaje exacto que ves y envíasela a tu soporte: con el texto literal, la solución suele ser inmediata.