⚙️ Guía Rápida de Ejecución: De la Descarga al Primer Análisis
Si ha llegado hasta aquí, tiene las herramientas de Python necesarias para transformar su gestión de cartera. Esta guía paso a paso le muestra las dos formas más sencillas de ejecutar el código en su ordenador o en la nube, sin necesidad de ser un experto en programación.
1. El Entorno de Trabajo y los Datos Necesarios
1. El Entorno de Trabajo y los Datos Necesarios
Los notebook están diseñados para ser ordenados. Al ejecutarse por primera vez, crearán automáticamente dos carpetas esenciales en la misma ubicación donde usted los descargue:
Datos: Contendrá todos los archivos de precios (.csv) que necesita la clase AnalizadorDeCartera. Informes: Se utilizará para guardar los reportes, gráficos o resultados generados por el script.
1.1. Personalización de Activos (self.fondos_data)
Antes de ejecutar, es crucial que el código sepa qué activos va a analizar. Esto se define en el diccionario "self.fondos_data " de la clase. Debe asegurarse de que los valores que quiera analizar estén en este diccionario, para descargar las cotizaciones desde Yahoo.
Estructura Requerida: Cada activo debe tener un nombre y las claves 'ISIN' y 'ticker'. Obtener Claves: El ticker (símbolo) y el ISIN de cualquier acción o fondo cotizado se pueden obtener de forma sencilla utilizando Yahoo Finance.
Ejemplo de Estructura
self.fondos_data = {
'Renta variable': {
'Vanguard Global Stock Index Fund EUR Acc': {'ISIN': 'IE00B03HD191', 'ticker': '0P00000WLG.F'},
# ... otros valores ...
},
'Índices': {
'S&P 500': {'ISIN': 'US78378X1072', 'ticker': '^GSPC'},
# ... otros valores ...
}
}
Archivos Locales (CSV/XLSX): En ambos directorios se pueden introducir ficheros CSV y xslx descargados de otros sitios Web- El nombre del archivo debe coincidir con el ISIN o el ticker definido en el diccionario.
Columnas: Deberán tener al menos las columnas 'Date' y 'Close' Formato de Fechas: Las fechas deben estar en el formato YYYY-MM-DD. Separador Decimal: El separador decimal debe ser el punto (.).
2. Opción A: Ejecución en la Nube (Google Colaboratory) ☁️
Esta es la opción más sencilla y recomendada si no desea instalar nada en su ordenador. Solo necesita una cuenta de Google.
Paso |
Windows y Linux |
|---|---|
1. Descarga y Acceso |
Haga clic en el enlace de descarga del notebook (.ipynb) que le hemos facilitado. Vaya a Google Colaboratory → Archivo → Subir notebook y seleccione el archivo. |
2. Subir Datos |
Una vez que el notebook se abra, deberá subir sus archivos de datos (su archivo mi_cartera.xlsx y los CSV de precios) al entorno de Colab. Haga clic en el icono de la carpeta en el menú lateral y luego en el icono de "Subir" para cargarlos. |
3. Ejecutar |
Ya puede ejecutar las celdas de código haciendo clic en el botón de Reproducir (▶️) de cada sección, o en Entorno de ejecución → Ejecutar todo. |
Esta opción le da control total sobre el entorno, pero requiere una configuración inicial.
4. Requisitos e Instalación de Herramientas
Sistema Operativo |
Instalación de Python 3 |
Instalación de JupyterLab |
|---|---|---|
Windows |
1. Descargar: Vaya al sitio web oficial de Python. 2. Ejecutar: Abra el instalador. ⚠️ Muy Importante: Marque la casilla "Add python.exe to PATH" antes de instalar. |
Abra el Símbolo del Sistema (CMD) y ejecute: bash<br>pip install jupyterlab<br>pip install pandas numpy openpyxl xirr<br> |
Linux (Debian/Ubuntu) |
Abra la Terminal (Ctrl + Alt + T) y ejecute: bash<br>sudo apt update<br>sudo apt install python3 python3-pip<br> |
Ejecute en la Terminal: bash<br>pip install jupyterlab<br>pip install pandas numpy openpyxl xirr<br> |
5. Acceso y Ejecución del Notebook
Debe usar la terminal para navegar a la carpeta donde está el proyecto y luego iniciar JupyterLab.
Paso |
Windows |
Linux |
|---|---|---|
1. Colocar Archivos |
Mueva el archivo .ipynb y todos los datos a una misma carpeta (ej: C:\Mis_Finanzas). |
Mueva el archivo .ipynb y todos los datos a una misma carpeta (ej: ~/Mis_Finanzas). |
2. Abrir Terminal |
Presione la tecla Windows y escriba cmd o PowerShell. |
Presione Ctrl + Alt + T. |
3. Cambiar Directorio (cd) |
Use el comando cd seguido de la ruta de su carpeta: bash<br>cd C:\Mis_Finanzas<br> |
Use el comando cd seguido de la ruta de su carpeta: bash<br>cd Mis_Finanzas<br> |
4. Iniciar JupyterLab |
Con el terminal posicionado en la carpeta correcta, ejecute: bash<br>jupyter lab<br> |
Con el terminal posicionado en la carpeta correcta, ejecute: bash<br>jupyter lab<br> |
Recordatorio: Si ejecuta localmente, verifique que las rutas de los archivos dentro del notebook (ej: RUTA_EXCEL_CARTERA) apunten correctamente a los ficheros en la carpeta de su ordenador.
