# Instalación

[**Cypress.io**](https://www.cypress.io/) es una aplicación GUI Test Runner que se instala en la computadora de manera muy sencilla en cualquier de los sistemas operativos:

{% hint style="warning" %}
**Sistemas operativos soportados por Cypress**\
\
macOS 10.9 and above (64-bit only) \
Linux Ubuntu 12.04 and above, Fedora 21 and Debian 8 (64-bit only) \
Windows 7 and above
{% endhint %}

Detrás de Cypress hay un proceso de [**Node.js**](https://nodejs.org/en/download/) donde se comunican, sincronizan y realizan tareas constantemente en nombre de cada uno. Por lo tanto, para ejecutar Cypress se necesita los siguientes paquetes:

{% hint style="warning" %}
**Prerrequisitos para instalar Cypress**\
\
Tener instalado **Node.js** y el paquete **NPM**: <https://nodejs.org/en/download/>\
Para verificar que ambos paquetes están instalados:\
**node - v**\
**npm -v**

Si tienes alguna duda de cómo instalar estos dos paquetes, puede seguir este tutorial:\
<https://blog.teamtreehouse.com/install-node-js-npm-windows>
{% endhint %}

### Instalación de Cypress

Es tan sencillo como abrir la carpeta del proyecto donde queremos instalar Cypress y ejecutamos el siguiente comando utilizando la herramienta `npm`

```
npm install cypress --save-dev
```

Luego debemos crear el archivo **package.json** para configurar las dependencias de Cypress a través del siguiente comando:

```
npm init
```

De esta forma Cypress se instalará en el directorio **./node\_modules**

![Cypress.io instalado en el workspace](/files/-Lqb8ayruEqVIDXsqJoR)

Antes de ejecutar Cypress, es importante modificar el archivo **package.json** con el fin de agregar un comando en el apartado *"scripts"* que nos permita abrir Cypress de una manera más sencilla:

```
"cypress:open": "cypress open"
```

Adicionalmente agregamos otro comando para ejecutar cypress sin levantar el runner a través del Cypress CLI:

```
"test": "cypress run spec"
```

Finalmente el archivo podría quedar así como la siguiente imagen

![Archivo package.json con las configuraciones adicionales](/files/-LqbAdBK_gpMyVD0tdQ1)

Ahora ya podemos ejecutar Cypress.io todas las veces que queramos simplemente escribiendo en la terminal el siguiente comando:

```
npm run cypress:open
```

![Ejecutando Cypress desde la terminal](/files/-LqbHjIABFlldQR8sYzG)

También es posible ejecutar Cypress ejecutando el comando `npx`

```
npx cypress open
```

Cada vez que iniciemos Cypress con el comando se abrirá el Test Runner de Cypress

![El Test Runner de Cypress inicializado](/files/-LqbIKcm_rek45AdTq8E)

Si deseas conocer más detalles de como instalar Cypress.io puedes ir directamente a la documentación oficial: <https://docs.cypress.io/guides/getting-started/installing-cypress.html#Opening-Cypress>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://douglasfugazi.gitbook.io/introduction-to-cypress/cypress/instalacion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
