Empezando

Dos roles, dos puntos de partida

Tu invitación determina lo que tienes que hacer el primer día. Elige el camino que matchea con tu rol.

BA Owner / Account Operator

Explorar y gobernar

Aceptar invitación → sign in → setear contexto de billing → listar workspaces en tu billing account → abrir dashboards en la UI.

No hace falta setup de BigQuery ni crear models. Cualquier workspace que tus developers hayan publicado en el billing account está listo para explorar en la UI.

Developer / Analytics Engineer

Construir y publicar

Aceptar invitación → sign in → setear contexto de billing → crear el service account de BigQuery → crear workspace → crear sources, models, visualizations, dashboards → push.

Esta guía usa BigQuery como camino inicial, así que se configura un service account de BigQuery antes de escribir models. Postgres y MySQL están igual de soportados — mira Sources si tus datos viven ahí.

Prerequisitos antes de correr comandos

Tienes una invitación a la cuenta target en https://my.looky.studio.
El CLI de Looky está instalado y disponible como looky en tu shell.
Tienes una carpeta local que va a actuar como el linked root (ejemplo: <local_root>).
Sabes el id del billing account en el que tienes que operar (ejemplo: <billing_account_id>).

Secuencia de día cero

Aceptar invitación y verificar tu rol y alcance (Invitación de Owner).
Hacer sign in en la UI, después linkear el CLI a la misma instancia y root (Sign In y conectar el CLI).
Solo developers: Emite un JSON de service account de GCP — lo vas a dejar en la carpeta secrets/ del workspace cuando exista, en el paso siguiente (Acceso al Dataset de BigQuery).
Setea el contexto de billing, crea el workspace, configura runtime/sources.runtime.yml, y despliega las settings con looky push --settings (Crea tu primer workspace).
Invita más builders solo después de que el primer workspace tenga sus sources desplegadas y al menos un push de content funcione (Invitar developers y colaboradores).

Flow base de comandos

looky login https://my.looky.studio <local_root>
looky whoami

cd <local_root>
looky billing list
looky billing use <billing_account_id>

cd <local_root>/<billing_account_id>
looky create <workspace_slug> --name "My Workspace"
cd <workspace_slug>
looky status

# Edita runtime/sources.runtime.yml con tus valores reales de source
# y deja el JSON de credenciales en secrets/. Después despliega:
looky push --settings

# Arma contenido bajo content/ (models, viz, dashboards). Después:
looky validate
looky push

looky login https://my.looky.studio <local_root>
looky whoami

Set-Location <local_root>
looky billing list
looky billing use <billing_account_id>

Set-Location <local_root>\<billing_account_id>
looky create <workspace_slug> --name "My Workspace"
Set-Location <workspace_slug>
looky status

# Edita runtime\sources.runtime.yml con tus valores reales de source
# y deja el JSON de credenciales en secrets\. Después despliega:
looky push --settings

# Arma contenido bajo content\ (models, viz, dashboards). Después:
looky validate
looky push

Success criteria antes de pasar a Build Workflow

looky whoami devuelve tu usuario autenticado para el linked root.
looky billing use <billing_account_id> tiene éxito desde <local_root>.
looky status resuelve un workspace id con shape <billing_account_id>/<workspace_slug>.
looky push --settings deploya la config de runtime sources sin errores.

Si alguno de estos falla, párate y arréglalo antes de crear dashboards. La mayoría de las fallas downstream son fallas de setup disfrazadas. Correr looky validate tiene sentido solo después de que las sources estén deployadas y haya contenido para compilar.