En este repositorio se encuentra el código de Intrinsic, una aplicación de escritorio open-source pensada para analizar informes financieros, extraer métricas clave y ayudarte a estudiar empresas de forma más rápida y structurada.
El nombre “Intrinsic” proviene del concepto de valor intrínseco de Benjamin Graham: la idea de que el valor real de una empresa está en sus fundamentales y no en la volatilidad del mercado. La aplicación sigue esa filosofía y está pensada para ayudar a analizar negocios de una forma estructurada y basada en datos.
Intrinsic permite cargar archivos financieros (PDF, HTML, MHTML…), detectar y extraer automáticamente los estados clave y generar ratios como P/E, P/BV, EV/CF operativo, ROE, ROA o márgenes. También incluye un sistema de puntuación que combina estas métricas para facilitar una valoración rápida. Todo se procesa en local, y ciertas partes del pipeline utilizan modelos LLM como GPT de OpenAI para interpretar informes complejos.
Instalación
La instalación es sencilla: basta con clonar el repositorio, instalar las dependencias y ejecutar la build. Es necesario tener Git, Node.js y una clave API de los proveedores soportados de IA para que la app pueda procesar informes no estructurados.
git clone https://github.com/vctrla/intrinsic
cd intrinsic
npm install
npm run build
Tras ello, Intrinsic se instala como una aplicación de escritorio en macOS, Windows o Linux. También se puede lanzar desde la terminal usando npm link.
Primeros pasos
La primera vez que abras Intrinsic tendrás que introducir tu API key desde el menú (icono de engranaje). Ahí también puedes ajustar el idioma, activar o desactivar TTM, cambiar el orden de los tickers, configurar colores, revisar la versión instalada o restablecer todos los datos.
Añadir una empresa
Para analizar una compañía basta con pulsar “+” y rellenar los campos obligatorios:
- Ticker de la empresa.
- Periodo del informe (año, trimestre o semestre) en formato YYYY-Y, YYYY-Q# o YYYY-S#.
- Fuente: una URL o un archivo local (PDF/HTML/MHTML). Para webs con renderizado en cliente, es necesario guardarlas como página “Single File”.
Es posible indicar páginas de inicio y fin para acelerar la extracción o evitar errores en documentos muy largos. Tras enviar el informe, se ejecuta el pipeline que interpreta el archivo y genera las métricas.
Exploración de datos
En la vista de la empresa puedes revisar estados financieros, comparar datos interanuales (YoY) y simular escenarios. Por ejemplo:
- Calcular un P/E objetivo y ver el precio que implicaría.
- Introducir un precio y obtener el score correspondiente.
- Comprobar cuánto debería crecer el beneficio para alcanzar un ratio específico.
Intrinsic maneja automáticamente datos TTM cuando hay periodos trimestrales o semestrales disponibles. También permite editar los valores si detectas algún error en el informe interpretado.
Score
La aplicación incluye un sistema de puntuación sencillo basado en tres ratios: EV/CF operativo, P/E y P/BV. Cada ratio contribuye con un peso distinto según su disponibilidad, y penaliza automáticamente empresas con beneficios, cash flow o valor contable negativos. La fórmula completa está documentada en el repositorio.
Docs
En intrinsic/docs puedes ver:
Errores comunes
Guía de errores frecuentes y buenas prácticas. Para evitar fallos al procesar informes financieros. Es recomendable revisarla, ya que los documentos corporativos son muy heterogéneos y el contexto influye en la extracción.
Hoja de ruta
Con Ideas de mejoras y nuevas funcionalidades que se tienen en mente.
Pipeline
La Pipeline a través de la que pasan los textos introducidos, cómo se limpian, modifican y normalizan anteriormente a ser ingeridos por el modelo de IA.
NER
En la carpeta NER se describe un proyecto paralelo más ambicioso: un sistema de extracción de información financiera basado en técnicas de reconocimiento de entidades (NER). Los documentos incluidos explican el planteamiento inicial y las pruebas realizadas para identificar métricas clave de forma totalmente local a partir de texto no estructurado.
Open-source
Intrinsic es un proyecto abierto con licencia MIT. Si te interesa, puedes examinar el código, abrir issues, proponer mejoras o adaptar la herramienta a tu propio flujo de análisis. La intención es crear una herramienta centralizada que sea el eje de tu portfolio, donde analices tus empresas, sigas sus finanzas, valores su rendimiento y tomes decisiones basadas en datos objetivos.