Guía Completa de Instalación
Tabla de Contenidos
1. Requisitos Previos
2. Instalación en Windows
3. Instalación en Linux
4. Instalación en macOS
5. Verificación de Instalación
6. Primeros Pasos
Requisitos Previos
Todos los Sistemas
● Conexión a Internet (para descargar datos de Yahoo Finance)
● Espacio en disco: Mínimo 500 MB
● RAM: Mínimo 2 GB
Windows
● Python 3.8 o superior
● pip (incluido con Python)
● Acceso de administrador (para instalar dependencias)
Linux
● Python 3.8 o superior
● pip (incluido con Python)
● venv (generalmente incluido)
● Acceso sudo (para instalar dependencias del sistema)
macOS
● Python 3.8 o superior
● pip (incluido con Python)
● Xcode Command Line Tools (opcional pero recomendado)
Instalación en Windows
Paso 1: Descargar Python
1. Visita [Link]
2. Descarga Python 3.11 o superior (versión más reciente)
3. Ejecuta el instalador
Paso 2: Instalar Python
IMPORTANTE: Durante la instalación:
● ✅ Marca la casilla "Add Python to PATH"
● ✅ Marca la casilla "Install pip"
● ✅ Marca la casilla "Install for all users" (opcional)
Haz clic en "Install Now" y espera a que termine.
Paso 3: Verificar Instalación
Abre PowerShell o CMD y ejecuta:
python --version
pip --version
Deberías ver algo como:
Python 3.11.x
pip 23.x.x
Paso 4: Descargar la Aplicación
1. Descarga todos los archivos del proyecto
2. Extrae en una carpeta (ej: C:\Users\TuUsuario\Documentos\dividend-
scanner)
Paso 5: Instalación Automática
1. Abre la carpeta del proyecto
2. Haz doble clic en [Link]
3. Espera a que se complete (puede tardar 2-5 minutos)
4. Presiona cualquier tecla cuando termine
Paso 6: Ejecutar la Aplicación
Opción A (Recomendado):
● Haz doble clic en [Link]
Opción B (Manual):
1. Abre PowerShell en la carpeta del proyecto
2. Ejecuta: venv\Scripts\[Link]
3. Ejecuta: python dividend_scanner.py
Instalación en Linux
Paso 1: Instalar Python
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install python3 python3-pip python3-venv
Fedora/RHEL:
sudo dnf install python3 python3-pip
Arch:
sudo pacman -S python python-pip
Paso 2: Verificar Instalación
python3 --version
pip3 --version
Paso 3: Descargar la Aplicación
# Crear carpeta
mkdir -p ~/dividend-scanner
cd ~/dividend-scanner
# Descargar archivos (o copiar manualmente)
# git clone <url-del-proyecto>
Paso 4: Instalación Automática
# Dar permisos de ejecución
chmod +x [Link]
# Ejecutar instalador
./[Link]
Espera a que se complete (puede tardar 2-5 minutos).
Paso 5: Ejecutar la Aplicación
Opción A (Recomendado):
./[Link]
Opción B (Manual):
source venv/bin/activate
python dividend_scanner.py
Instalación en macOS
Paso 1: Instalar Python
Opción A: Usando Homebrew (Recomendado)
# Instalar Homebrew si no lo tienes
/bin/bash -c "$(curl -fsSL
[Link]
# Instalar Python
brew install python3
Opción B: Descargar desde [Link]
1. Visita [Link]
2. Descarga el instalador para macOS
3. Ejecuta el instalador
Paso 2: Verificar Instalación
python3 --version
pip3 --version
Paso 3: Descargar la Aplicación
# Crear carpeta
mkdir -p ~/dividend-scanner
cd ~/dividend-scanner
# Descargar archivos (o copiar manualmente)
Paso 4: Instalación Automática
# Dar permisos de ejecución
chmod +x [Link]
# Ejecutar instalador
./[Link]
Espera a que se complete.
Paso 5: Ejecutar la Aplicación
Opción A (Recomendado):
./[Link]
Opción B (Manual):
source venv/bin/activate
python dividend_scanner.py
Verificación de Instalación
Verificar que Todo Está Instalado
Windows:
# Abre PowerShell en la carpeta del proyecto
venv\Scripts\[Link]
pip list
Linux/macOS:
source venv/bin/activate
pip list
Deberías ver:
● yfinance
● pandas
● openpyxl
● requests
Verificar Conexión a Internet
python -c "import yfinance as yf; print([Link]('AAPL').info['currentPrice'])"
Si ves un número, ¡la conexión funciona!
Primeros Pasos
1. Ejecutar con Configuración Predeterminada
# Windows
[Link]
# Linux/macOS
./[Link]
Esto analizará 60 acciones populares y generará un reporte.
2. Personalizar Acciones
Edita [Link]:
{
"tickers": [
"AAPL",
"MSFT",
"TUS_ACCIONES"
]
}
3. Ejecutar Nuevamente
# Windows
[Link]
# Linux/macOS
./[Link]
4. Revisar el Reporte
El archivo Excel se guardará en:
reports/dividend_report_YYYYMMDD_HHMMSS.xlsx
Abre con Excel, LibreOffice o Google Sheets.
Instalación Manual (Avanzado)
Si prefieres instalar manualmente:
Windows
# Crear entorno virtual
python -m venv venv
# Activar entorno virtual
venv\Scripts\[Link]
# Instalar dependencias
pip install -r [Link]
# Crear directorios
mkdir cache
mkdir reports
Linux/macOS
# Crear entorno virtual
python3 -m venv venv
# Activar entorno virtual
source venv/bin/activate
# Instalar dependencias
pip install -r [Link]
# Crear directorios
mkdir -p cache
mkdir -p reports
Solución de Problemas de Instalación
❌ "Python no está en el PATH"
Windows:
1. Desinstala Python
2. Reinstala marcando "Add Python to PATH"
3. Reinicia tu computadora
Linux/macOS:
# Verifica dónde está Python
which python3
# Si no está en /usr/bin, crea un enlace
sudo ln -s /usr/bin/python3.11 /usr/bin/python3
❌ "pip no está instalado"
Windows:
python -m pip install --upgrade pip
Linux/macOS:
python3 -m pip install --upgrade pip
❌ "No se puede crear el entorno virtual"
# Instala venv
# Ubuntu/Debian
sudo apt-get install python3-venv
# Fedora
sudo dnf install python3-venv
# macOS
brew install python3
❌ "Error instalando dependencias"
# Actualiza pip
python -m pip install --upgrade pip
# Intenta instalar nuevamente
pip install -r [Link] --force-reinstall
❌ "Permiso denegado" (Linux/macOS)
# Dale permisos a los scripts
chmod +x [Link]
chmod +x [Link]
# Ejecuta con bash
bash [Link]
bash [Link]
Próximos Pasos
1. Lee el [Link] para entender todas las características
2. Personaliza [Link] con tus acciones favoritas
3. Ejecuta la aplicación regularmente para monitorear dividendos
4. Consulta ADVANCED_USAGE.md para usos avanzados
Soporte
Si tienes problemas:
1. Revisa [Link]
2. Verifica el archivo de registro: dividend_scanner.log
Intenta una instalación limpia:
# Elimina el entorno virtual
rm -rf venv # Linux/macOS
rmdir /s venv # Windows
# Ejecuta [Link] o [Link] nuevamente
3.
¡Instalación completada! 🎉
Ahora puedes ejecutar la aplicación con [Link] (Windows) o ./[Link] (Linux/macOS).