# Inicio rápido

En pocos minutos tendrá un <Term id="workspace">espacio de trabajo</Term>, un primer <Term id="project">proyecto</Term>, una <Term id="table">tabla</Term> en <Term id="nexus">Nexus</Term> y la respuesta a su primera consulta <Term id="sql">SQL</Term>.

## Antes de empezar [#antes-de-empezar]

Solo necesita una idea. Descríbala a la IA de su proyecto y empiece a escribirle.

Opcional, cuando lo quiera:

- **GitHub**, para guardar su código en su propio repositorio.
- **Sus propios datos**, como una hoja de cálculo o un archivo CSV.
- **Para desarrolladores:** Python 3.11 o posterior, y una clave de API de un propietario o administrador.

<Callout type="info" title="Los desarrolladores necesitan un administrador">
Solo los propietarios y administradores del espacio de trabajo pueden crear claves de API. Si es miembro, pida una clave a un administrador.
</Callout>

## 1. Regístrese y configure su espacio de trabajo [#1-regístrese-y-configure-su-espacio-de-trabajo]

La primera vez que inicia sesión, Klarety lo guía por una bienvenida corta. Todo se puede cambiar después en Configuración.

<Steps>
<Step>
### Configure su perfil [#configure-su-perfil]
Agregue su nombre, una foto opcional y un cargo. Así lo ven sus compañeros.
</Step>
<Step>
### Nombre su espacio de trabajo [#nombre-su-espacio-de-trabajo]
Aquí viven sus proyectos, datos y equipo. Use el nombre de su empresa o equipo; puede cambiarlo cuando quiera.
</Step>
<Step>
### Conecte GitHub [#conecte-github]
Permite que sus proyectos envíen código y desplieguen con cada push. Elija **Omitir** para hacerlo después desde Inicio.
</Step>
<Step>
### Manténgase al día [#manténgase-al-día]
Enlaces opcionales para seguir las novedades de Klarety. Continúe cuando esté listo.
</Step>
<Step>
### Empiece su prueba gratis [#empiece-su-prueba-gratis]
Empiece la prueba gratis de Pro para desbloquear proyectos, Studios y sus datos. La página muestra cuántos días dura. Cancele en cualquier momento antes de que termine.
</Step>
</Steps>

Llega a **Inicio**. Su lista **Primeros pasos** sigue los mismos pasos: crear su primer proyecto, conectar GitHub, agregar sus datos, conectar una herramienta y configurar un agente.

<Screenshot src="/docs/_media/dashboard-home.png" alt="La página de Inicio con la lista de primeros pasos" />

## 2. Cree su primer proyecto [#2-cree-su-primer-proyecto]

Un proyecto guarda su código, su <Term id="studio">Studio</Term> y sus despliegues. Necesita uno para construir, ejecutar agentes o desplegar.

<ForEveryone>
<Steps>
<Step>
### Empiece un proyecto nuevo [#empiece-un-proyecto-nuevo]
En <AppLink to="home" /> seleccione **Nuevo proyecto**, o abra <AppLink to="projects.new" />.
</Step>
<Step>
### Póngale nombre [#póngale-nombre]
Escriba un nombre para el proyecto. El **Tamaño** predeterminado basta. Deje **Cómo funciona** en la máquina compartida estándar: si se recupera, una nueva arranca sola y no se pierde trabajo.
</Step>
<Step>
### Créelo [#créelo]
Seleccione **Crear proyecto**. El proyecto se abre y su Studio arranca.

<Screenshot src="/docs/_media/projects-new.png" alt="El formulario Nuevo proyecto con nombre, Tamaño y Cómo funciona" />
</Step>
</Steps>

Para todas las opciones, vea [Crear un proyecto](/docs/es/projects/create-a-project).
</ForEveryone>

<ForDevelopers>
Primero instale el SDK y cree una clave de API (ambos en la sección 4), y luego:

```python
from klarety import Nexus

nx = Nexus.connect()  # reads KLARETY_API_KEY
project = nx.projects.create("My first project")
print(project)
```

Para todas las opciones, vea [Crear un proyecto](/docs/es/projects/create-a-project).
</ForDevelopers>

## 3. Agregue sus datos [#3-agregue-sus-datos]

Klarety convierte hojas de cálculo y archivos CSV en tablas de Nexus, su base de datos.

<ForEveryone>
<Steps>
<Step>
### Abra Agregar datos [#abra-agregar-datos]
Vaya a <AppLink to="data" /> y elija **Convertir una hoja de cálculo en tabla**.
</Step>
<Step>
### Suba el archivo [#suba-el-archivo]
Elija su archivo. Klarety muestra las columnas encontradas y sugiere un nombre de tabla que puede cambiar.
</Step>
<Step>
### Importe [#importe]
Seleccione **Importar** y luego abra la tabla para ver sus filas. El archivo original también se guarda en una carpeta.
</Step>
</Steps>
</ForEveryone>

<ForDevelopers>
```python
from klarety import Nexus

nx = Nexus.connect()
run = nx.ingest("orders.csv", into="orders")
print(run.run_id, run.state)
print(nx.ingest_status(run.run_id).state)
```

La carga se ejecuta en segundo plano; `ingest_status` le dice cuándo terminó. Vea [Cargar datos](/docs/es/developers/ingest) para modos como agregar filas o actualizar filas por clave.
</ForDevelopers>

<Screenshot src="/docs/_media/nexus-add-data.png" alt="Convertir una hoja de cálculo en tabla, con las columnas encontradas" />

## 4. Ejecute su primera consulta [#4-ejecute-su-primera-consulta]

<ForEveryone>
<Steps>
<Step>
### Abra el Editor SQL [#abra-el-editor-sql]
Vaya a <AppLink to="data.sql" />. El panel lateral muestra sus tablas; haga clic en un nombre para insertarlo.
</Step>
<Step>
### Escriba una consulta [#escriba-una-consulta]
```sql
SELECT * FROM orders LIMIT 100
```
Cambie `orders` por el nombre de su tabla.
</Step>
<Step>
### Ejecútela [#ejecútela]
Seleccione **Ejecutar** o pulse Cmd Enter (Ctrl Enter en Windows). Las filas aparecen debajo del editor, con el número de filas.
</Step>
</Steps>
</ForEveryone>

<ForDevelopers>

<Callout type="info" title="Disponible bajo solicitud">
El SDK y la CLI de Klarety están disponibles bajo solicitud. Para solicitar acceso para su espacio de trabajo, [contáctenos](https://klarety.ai/contact).
</Callout>

<Steps>
<Step>
### Instale el SDK [#instale-el-sdk]
```bash
pip install klarety
```
</Step>
<Step>
### Cree una clave de API [#cree-una-clave-de-api]
En la aplicación, abra <AppLink to="settings.sdk-api" /> y seleccione **Crear clave**. Tras confirmar que es usted, dele a la clave un **Nombre**, elija su **Acceso** y cuándo **Vence**, y cópiela. Solo se muestra una vez.
</Step>
<Step>
### Conéctese y consulte [#conéctese-y-consulte]
```bash
export KLARETY_API_KEY="your-key"
```

```python title="first_query.py"
from klarety import Nexus

nx = Nexus.connect()
print(nx.account().credits)

result = nx.sql("SELECT * FROM orders LIMIT 100")
for row in result.rows:
    print(row)
```

`Nexus.connect` cambia la clave una vez por un token de una hora y lo renueva por usted.
</Step>
<Step>
### O use la línea de comandos [#o-use-la-línea-de-comandos]
```bash
klarety login your-key
klarety sql "SELECT * FROM orders LIMIT 100"
```
`klarety login` guarda la clave en el llavero de su sistema operativo.
</Step>
</Steps>
</ForDevelopers>

## Compruebe que funcionó [#compruebe-que-funcionó]

- Su proyecto aparece en <AppLink to="projects" />.
- Su tabla aparece en **Nexus Lakehouse**, dentro de <AppLink to="data" />.
- Su consulta devuelve filas. Si no, revise el nombre de la tabla en el panel lateral del Editor SQL.

## Si algo sale mal [#si-algo-sale-mal]

<Accordions>
<Accordion title="La página de la prueba no se abrió">
Elija **Intentar de nuevo**. Si sigue fallando, actualice la página y empiece el paso otra vez.
</Accordion>
<Accordion title="No puedo crear una clave de API">
Solo los propietarios y administradores gestionan las claves de API. Pida a un administrador que cree una o que le dé el rol. Un espacio de trabajo tiene un número limitado de claves activas: revoque una que ya no use.
</Accordion>
<Accordion title="La consulta dice que la tabla no existe">
Revise el nombre exacto en el panel lateral del Editor SQL, o liste las tablas con `nx.tables.list()` o `klarety tables`.
</Accordion>
<Accordion title="El resultado se corta antes de la última fila">
Los resultados tienen un tope según su plan. Agregue un `LIMIT` o un `WHERE` para acotar la consulta. Sus límites están en <AppLink to="settings.usage" />.
</Accordion>
</Accordions>

## Siguientes pasos [#siguientes-pasos]

- [Conceptos clave](/docs/es/get-started/concepts): qué es cada parte de Klarety.
- [Su primer proyecto](/docs/es/guides/first-project): abra el Studio y haga su primer cambio.
- [Hágale una pregunta a sus datos](/docs/es/guides/first-query): vaya más allá con SQL.
- [Cree su primer agente](/docs/es/guides/first-agent): deje que Klarety haga trabajo repetitivo por usted.