# Instalación (/es/docs/verdent-manager/getting-started/installation)

> Guía paso a paso para instalar y configurar Verdent



Esta guía te muestra cómo descargar Verdent, completar la instalación específica de cada plataforma y autenticarte con tu cuenta de Verdent.

***

## Requisitos [#requisitos]

Antes de instalar Verdent, asegúrate de que tu sistema cumpla con estos requisitos previos:

### Requisitos del sistema [#requisitos-del-sistema]

* **Sistema operativo**: macOS 11+ o Windows 10+ (64 bits). Consulta [Sistemas operativos compatibles](/docs/verdent-manager/getting-started/supported-operating-systems) para conocer todos los detalles de compatibilidad.
* **Git**: Versión 2.20 o superior. Verdent usa worktrees de Git para aislar los espacios de trabajo. Tu carpeta de proyecto no necesita ser un repositorio de Git, pero algunas funciones requieren Git y Verdent puede guiarte para inicializar un repositorio cuando sea necesario.
  * **macOS:** Git se incluye con las Xcode Command Line Tools. Instálalas con `xcode-select --install` o usa Homebrew: `brew install git`.
  * **Windows:** Descarga el instalador oficial desde [git-scm.com/download/win](https://git-scm.com/download/win) y acepta las opciones predeterminadas.
  * Verifica con `git --version` en una terminal.
* **Conexión a internet**: Se requiere una conexión activa para la comunicación con el servicio de IA

### Opcional pero recomendado [#opcional-pero-recomendado]

* **Espacio en disco**: Al menos 2 GB libres (se recomienda más para repositorios grandes, worktrees y almacenamiento en caché)

***

## Descarga [#descarga]

Descarga Verdent desde el sitio web oficial:

**[verdent.ai/download](https://verdent.ai/download)**

Selecciona tu sistema operativo para descargar el instalador adecuado.

***

## Instalación en macOS [#instalación-en-macos]

<Steps>
  <Step title="Descarga">
    Descarga el archivo `.dmg` desde [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="Abre el DMG">
    Haz doble clic en el archivo `.dmg` descargado para montarlo
  </Step>

  <Step title="Instala">
    Arrastra el icono de Verdent a la carpeta Aplicaciones
  </Step>

  <Step title="Inicia">
    Abre Aplicaciones y haz doble clic en Verdent
  </Step>

  <Step title="Aprobación de seguridad">
    Si se te solicita, abre **Configuración del Sistema → Privacidad y seguridad** (macOS 13+) o **Preferencias del Sistema → Seguridad y privacidad** (versiones anteriores de macOS) y selecciona **Abrir de todos modos**
  </Step>
</Steps>

**Versiones de macOS compatibles:**

* macOS 11 (Big Sur) y posteriores
* Compatible con Intel y Apple Silicon

***

## Instalación en Windows [#instalación-en-windows]

<Steps>
  <Step title="Descarga">
    Descarga el instalador `.exe` desde [verdent.ai/download](https://verdent.ai/download)
  </Step>

  <Step title="Ejecuta el instalador">
    Haz doble clic en el archivo `.exe` descargado
  </Step>

  <Step title="Aviso de UAC">
    Selecciona **Sí** cuando el Control de cuentas de usuario te lo solicite
  </Step>

  <Step title="Opciones de instalación">
    Sigue las indicaciones del instalador (algunas versiones podrían no ofrecer un directorio de instalación personalizado)
  </Step>

  <Step title="Completa">
    Selecciona **Instalar** y espera a que finalice
  </Step>

  <Step title="Inicia">
    Selecciona **Finalizar** para iniciar Verdent, o búscalo en el menú Inicio
  </Step>
</Steps>

**Versiones de Windows compatibles:**

* Windows 10
* Windows 11
* Solo 64 bits

***

## Autenticación y configuración [#autenticación-y-configuración]

Después de la instalación, deberás autenticarte con tu cuenta de Verdent para empezar a usar la aplicación.

### Autenticación inicial [#autenticación-inicial]

<Steps>
  <Step title="Inicia Verdent">
    Abre Verdent desde Aplicaciones (macOS) o el menú Inicio (Windows). Aparece la pantalla de bienvenida.
  </Step>

  <Step title="Inicia sesión">
    Selecciona **Iniciar sesión**. Tu navegador se abrirá en la página de autenticación de Verdent.
  </Step>

  <Step title="Autenticación en el navegador">
    Inicia sesión con las credenciales de tu cuenta de Verdent (correo electrónico/contraseña o proveedores de OAuth como Google, GitHub, etc.).
  </Step>

  <Step title="Vuelve a la aplicación">
    Regresa a Verdent una vez completada la autenticación. Verás la interfaz principal.
  </Step>

  <Step title="Abre un proyecto">
    Elige **Abrir proyecto** para seleccionar un directorio, o **Proyectos recientes** si vuelves a entrar.
  </Step>
</Steps>

***

## Verificación de la instalación [#verificación-de-la-instalación]

Confirma que tu instalación funciona correctamente con estas comprobaciones sencillas:

### Verificación visual [#verificación-visual]

1. **Icono de la aplicación** - Verdent aparece en Aplicaciones (macOS) o en el menú Inicio (Windows)
2. **Sesión iniciada** - Puedes ver el estado de tu cuenta en la aplicación después de autenticarte (por ejemplo, avatar/correo electrónico)

### Verificación funcional [#verificación-funcional]

<Steps>
  <Step title="Abre un proyecto">
    Abre un directorio en Verdent.
  </Step>

  <Step title="Envía un prompt de prueba">
    Prueba una solicitud sencilla como "Explica qué contiene este proyecto" en el cuadro de entrada.
  </Step>

  <Step title="Recibe una respuesta">
    Verdent debería analizar tu proyecto y ofrecer una respuesta en poco tiempo.
  </Step>
</Steps>

**Indicadores de éxito:**

* Verdent se inicia sin errores
* Cuenta autenticada correctamente
* Puedes enviar prompts y recibir respuestas

<Warning>
  Verdent requiere una conexión a internet activa para las funciones de IA. Si los prompts no responden, verifica tu conectividad de red y asegúrate de que tu firewall permita el tráfico HTTPS saliente hacia los endpoints de API de Verdent.
</Warning>

***

## Resolución de problemas de instalación [#resolución-de-problemas-de-instalación]

<Tabs>
  <Tab title="Seguridad en macOS">
    **Problema:** "Verdent no se puede abrir porque proviene de un desarrollador no identificado"

    **Solución:**

    1. Abre **Configuración del Sistema → Privacidad y seguridad** (macOS 13+) o **Preferencias del Sistema → Seguridad y privacidad** (versiones anteriores de macOS)
    2. Busca el mensaje de advertencia de Verdent
    3. Selecciona **Abrir de todos modos**
    4. Confirma seleccionando **Abrir**
  </Tab>

  <Tab title="Windows Defender">
    **Problema:** Windows Defender bloquea la instalación

    **Solución:**

    1. Selecciona **Más información** en la ventana emergente de SmartScreen
    2. Si descargaste Verdent desde el sitio web oficial y confías en la fuente, selecciona **Ejecutar de todos modos**
    3. Continúa con la instalación
  </Tab>
</Tabs>

***

## Preguntas frecuentes [#preguntas-frecuentes]

<AccordionGroup>
  <Accordion title="¿Puedo instalar Verdent junto con la extensión VS Code?">
    Sí. Verdent y la extensión VS Code son aplicaciones independientes. Puedes usar ambas y comparten el mismo conjunto de créditos y la misma cuenta.
  </Accordion>

  <Accordion title="¿Cómo actualizo Verdent?">
    Verdent busca actualizaciones automáticamente al iniciarse. Cuando hay una actualización disponible:

    1. Aparece una notificación
    2. Selecciona **Actualizar** para descargarla e instalarla
    3. Reinicia la aplicación

    También puedes comprobarlo manualmente desde el menú de la aplicación (por ejemplo: **Ayuda → Buscar actualizaciones**).
  </Accordion>

  <Accordion title="¿Cómo desinstalo Verdent?">
    **macOS:** Arrastra Verdent desde Aplicaciones a la Papelera

    **Windows:** Usa **Configuración → Aplicaciones → Verdent → Desinstalar** o **Panel de control → Programas y características**
  </Accordion>
</AccordionGroup>

***

## Próximos pasos [#próximos-pasos]

<CardGroup cols="2">
  <Card title="Inicio rápido" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    Agrega tu primer proyecto y asigna una tarea
  </Card>

  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Aprende cómo Manager planifica, distribuye y hace seguimiento del trabajo
  </Card>
</CardGroup>