---
title: Instalación
description: "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

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

### 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

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

---

## 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

<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

<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

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

### 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

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

### 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

<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

<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

<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

<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>