# Crear un proyecto

Un <Term id="project">proyecto</Term> es donde usted construye algo sobre sus datos: una aplicación, un tablero, una herramienta o un <Term id="agent">agente</Term>. Cada uno tiene su propio <Term id="studio">**Studio**</Term>, un espacio privado en la nube con una IA, un editor de código, una vista previa de su aplicación y acceso a sus datos. Use un proyecto por aplicación, para que su código, sus secretos y sus personas queden separados.

<TrustBadges />

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

- Necesita un <Term id="workspace">espacio de trabajo</Term> de Klarety y <Term id="credits">créditos</Term>.
- Para guardar código en GitHub, un administrador del espacio de trabajo conecta GitHub una sola vez para todos los proyectos. Consulte [GitHub](/docs/es/connectors/github). También puede vincular un repositorio después.
- Los compañeros que invite ya deben ser miembros de su espacio de trabajo. Consulte [Miembros](/docs/es/workspace/members).

<Callout type="warn" title="Un Studio en marcha usa créditos">
Un Studio usa los créditos del espacio de trabajo mientras está en marcha, cobrados por minuto. Se detiene solo cuando nadie lo usa. Consulte [Créditos](/docs/es/workspace/credits).
</Callout>

## Crear el proyecto [#crear-el-proyecto]

<ForEveryone>
<Steps>
<Step>
### Abra Nuevo proyecto [#abra-nuevo-proyecto]
Vaya a <AppLink to="projects.new" />, o seleccione **Nuevo proyecto** en Inicio o en la página de Proyectos.
</Step>
<Step>
### Póngale nombre [#póngale-nombre]
Escriba un **Nombre del proyecto** (obligatorio). Puede cambiarlo después.
</Step>
<Step>
### Elija un tamaño [#elija-un-tamaño]
En **Tamaño**, elija la máquina de su Studio. Cada una muestra sus núcleos y su memoria. Starter basta para empezar; una más grande es más rápida y cuesta más. Puede cambiarlo después.
</Step>
<Step>
<Screenshot src="/docs/_media/studio-sizes.png" alt="Las opciones de tamaño: Starter, Builder y Pro, con el complemento Premium" />

### Elija cómo funciona [#elija-cómo-funciona]
En **Cómo funciona**, elija una máquina estándar o **Premium** (vea más abajo).
</Step>
<Step>
### Ajuste lo demás (opcional) [#ajuste-lo-demás-opcional]
- **Harness de IA**: las IA que ofrece este proyecto. Consulte [Cómo funciona el AI harness](/docs/es/ai-harness).
- **Conectar GitHub**: el repositorio donde este proyecto guarda su código y desde el que se despliega.
- **Invitar personas**: compañeros de su espacio de trabajo.
- **Acceso a internet**: a qué puede llegar el Studio (vea más abajo).
- **Configuración avanzada**: suspensión, copias de seguridad y Klarety Buddy. Los valores que fija su plan muestran "Definido por su plan".
</Step>
<Step>
### Créelo [#créelo]
Seleccione **Crear proyecto** (o presione ⌘ Enter). El resumen junto al formulario muestra la máquina, el disco, el acceso a internet y el costo en créditos por hora.
</Step>
</Steps>

<Screenshot src="/docs/_media/new-project-advance-settings.png" alt="El formulario Nuevo proyecto con tamaño, cómo funciona y acceso a internet" />
</ForEveryone>

<ForDevelopers>
Cree un proyecto e inicie su Studio con el SDK. `studios.open` responde en cuanto se acepta la solicitud, así que consulte `studios.get` hasta que el estado sea `READY`.

```python title="create_project.py"
import time

from klarety import Nexus

nx = Nexus.connect()

project = nx.projects.create("Sales dashboard")
project_id = project["project_id"]

nx.studios.open(project_id)
while (studio := nx.studios.get(project_id))["state"] != "READY":
    time.sleep(5)

print(studio["editor_url"])
```

`projects.create` también acepta `repo_url` para vincular un repositorio. Para detener el Studio y conservar su trabajo, llame a `nx.studios.close(project_id)`.
</ForDevelopers>

## Estándar o Premium [#estándar-o-premium]

Cada Studio funciona en AWS, en un espacio seguro y aislado, con discos cifrados en reposo. **Cómo funciona** decide la máquina:

| Opción | Lo que dice la aplicación | Cuándo usarla |
| --- | --- | --- |
| Máquina estándar | "Máquina compartida que puede ser retirada en cualquier momento. Una nueva arranca sola y no se pierde trabajo." | La mayoría del trabajo. Cuesta menos. |
| Máquina Premium (complemento) | "Nunca se duerme. Nunca se interrumpe." | Trabajos largos que no quiere que se reinicien, o un Studio que debe seguir activo. |

Con Premium, la máquina es suya mientras el Studio esté en marcha. Seleccione **Agregar** para usarlo. "No está en su plan" significa que su plan no lo incluye. Puede cambiar después con **Cambiar a Premium**.

## Acceso a internet [#acceso-a-internet]

| Opción | A qué puede llegar el Studio |
| --- | --- |
| Activado | A toda la web y a sus conexiones. |
| Solo permitidos | Solo a sus conexiones y a los sitios que agregue. |
| Desactivado | A nada fuera de Klarety, así que las conexiones no funcionan. |

Si su plan no permite agregar sitios, el Studio solo puede llegar a sus conexiones.

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

Su proyecto aparece en <AppLink to="projects" />. Seleccione **Iniciar Studio** en su tarjeta y confirme. Mientras arranca, verá "Verificando su plan y sus créditos", "Buscando capacidad", "Restaurando su espacio de trabajo" e "Iniciando el editor". Cuando el estado diga **En ejecución**, ábralo.

## Encontrar y organizar proyectos [#encontrar-y-organizar-proyectos]

La página de Proyectos los muestra como **Tablero** (columnas Detenidos, En ejecución, Desplegados y Con error), **Cuadrícula** o **Lista**. Filtre por rol, etiquetas o estado del Studio, y ordene por última actualización. Seleccione **Guardar como vista** para conservar una vista.

<Screenshot src="/docs/_media/dashboard-projects.png" alt="La página Proyectos con todos los proyectos del espacio de trabajo" />

<Screenshot src="/docs/_media/command-center-search.png" alt="Búsqueda de proyectos, páginas, configuración y acciones" />

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

<Accordions>
<Accordion title="El Studio no se inició">
Verá "Este Studio no se inició. No se perdió nada." Seleccione **Iniciar de nuevo**. Si falta capacidad, el Studio sigue intentando por sí solo y muestra el número de intento.
</Accordion>
<Accordion title="Se quedó sin créditos">
Un Studio no puede iniciar sin créditos. Compre más desde **Créditos** en el menú de su cuenta. Consulte [Créditos](/docs/es/workspace/credits).
</Accordion>
<Accordion title="GitHub dice Sin conectar">
Un administrador del espacio de trabajo conecta GitHub una sola vez para todo el espacio de trabajo, en <AppLink to="settings.connected-accounts" />. Si usted no es administrador, pídaselo a uno.
</Accordion>
</Accordions>

## Siguientes pasos [#siguientes-pasos]

- [El Studio](/docs/es/projects/studio)
- [Configuración del proyecto](/docs/es/projects/settings)
- [Secretos y variables de entorno](/docs/es/projects/project-secrets)
- [Desplegar una aplicación](/docs/es/deploy/deploy-an-app)