Skip to content
BCN Extractor

Instalación

Requisitos previos

Section titled “Requisitos previos”

Antes de instalar BCN Extractor necesitas tener:

  • Docker Desktop (o Docker Engine + Docker Compose)
  • Python 3.9 o superior
  • Git

Instalación

Section titled “Instalación”

  1. Clonar el repositorio

    Terminal window
    git clone https://github.com/AlexFT257/BCNExtractor.git
    cd BCNExtractor

  2. Levantar la base de datos con Docker

    Terminal window
    docker-compose up -d

    Esto inicia un contenedor PostgreSQL en el puerto 5432 con los volúmenes configurados.

  3. Instalar dependencias Python

    Terminal window
    pip install -r requirements.txt

  4. Configurar variables de entorno

    Terminal window
    cp .env.example .env

    Edita el archivo .env con tus credenciales:

    .env
    DB_HOST=localhost
    DB_PORT=5432
    DB_NAME=bcn_extractor
    DB_USER=postgres
    DB_PASSWORD=tu_password_segura

  5. Verificar la instalación

    Terminal window
    python bcn_cli.py stats

    Si ves las estadísticas de la base de datos (vacías al principio), la instalación fue exitosa.

Variables de entorno

Section titled “Variables de entorno”
VariableDescripciónDefault
DB_HOSTHost de PostgreSQLlocalhost
DB_PORTPuerto de PostgreSQL5432
DB_NAMENombre de la base de datosbcn_extractor
DB_USERUsuario de PostgreSQLpostgres
DB_PASSWORDContraseña de PostgreSQL—
BCN_RATE_LIMITSegundos entre requests a la BCN1.0
BCN_MAX_RETRIESReintentos máximos por request3

Estructura Docker

Section titled “Estructura Docker”

El docker-compose.yml levanta:

  • PostgreSQL 15 en el puerto 5432
  • Volumen persistente para los datos en ./docker/data
  • Scripts de inicialización en ./docker/init-scripts/
Terminal window
# Comandos útiles de Docker
docker-compose up -d       # Levantar en background
docker-compose down        # Detener contenedores
docker-compose logs -f     # Ver logs en tiempo real
docker-compose ps          # Estado de los contenedores