Inicio rápido

Instalar el SDK en tu proyecto, configurar credenciales y verificar conectividad.

Trabajá dentro del proyecto que recibiste de Brightmarket o descargaste en Obtener tu proyecto.

1. Credenciales CodeArtifact (primero)

Sin esto no podés instalar brightmarket-data-sync. Tu administrador te entrega credenciales IAM de lectura (bgmkt-codeartifact-reader).

cp login_aws.env.example login_aws.env   # completar keys

2. Entorno virtual e instalación

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

./scripts/auth-pip.sh                    # token pip ~12 h
pip install -r requirements.txt

Tu requirements.txt ya incluye el pin del SDK, por ejemplo:

brightmarket-data-sync==X.Y.Z
pyodbc==5.2.0
python-dotenv==1.0.1
tqdm==4.67.0

Si pip install devuelve 401, volvé a ejecutar ./scripts/auth-pip.sh.

3. Variables de entorno

cp .env.example .env

Variable	Quién la usa	Descripción
`API_URL_BRIGHT`	SDK	URL base de la API
`USER_EMAIL_BRIGHT`	SDK	Email del usuario Brightmarket
`USER_PASSWORD_BRIGHT`	SDK	Contraseña
`USER_ORG_BRIGHT`	SDK	Organización
`DB_*`	Tu proyecto	Conexión a tu fuente de datos
`BUSINESS_UNIT_ID`	Tu proyecto	Business unit en Brightmarket

El SDK solo lee las variables *_BRIGHT. Tu main.py debe cargar .env con load_dotenv() al inicio.

4. Verificar instalación

python -c "import brightmarket_data_sync; print(brightmarket_data_sync.__file__)"
python -m src.main -test

-test verifica conexión a tu BD y login en la API Brightmarket sin sincronizar datos.

Próximo paso

Guía de implementación — implementar adapter y módulos sync.