🚀 Instalación paso a paso

Siga estos pasos para instalar J.A.R.V.I.S. en su equipo Windows. El proceso completo dura unos 10-15 minutos.

⚠️ Requisitos previos

Antes de empezar, asegúrese de tener instalado Python 3.11+, Ollama y Git. Consulte Requisitos del sistema para los enlaces de descarga.

Obtener el código fuente

Tiene dos opciones para descargar JARVIS:

Opción A — Clonar con Git

Abra PowerShell y ejecute:

git clone https://github.com/Pausiar/JARVIS_Docs.git
cd JARVIS_Docs

Requiere tener Git instalado. Permite actualizar fácilmente con git pull.

Opción B — Descargar ZIP

Descargue directamente desde GitHub:

⬇️ Descargar ZIP

Descomprima el ZIP en la ubicación que prefiera. No requiere Git.

En ambos casos, obtendrá una carpeta con todo el código fuente de JARVIS. Abra un terminal en esa carpeta para continuar.

Crear entorno virtual

Un entorno virtual aísla las dependencias de JARVIS del resto de su sistema:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

Si usa CMD en vez de PowerShell:

.\.venv\Scripts\activate.bat

💡 ¿Cómo sé que está activado?

Verá (.venv) al inicio de la línea del terminal.

Instalar dependencias

pip install -r requirements.txt

Esto instala todas las librerías necesarias (PySide6, pyautogui, faster-whisper, etc.).

Si alguna dependencia falla, instale las esenciales manualmente:

pip install PySide6 requests psutil keyboard pynput pyautogui faster-whisper numpy sounddevice pycaw comtypes PyMuPDF python-docx openpyxl Pillow piper-tts

Si tiene problemas, consulte Resolución de problemas.

Descargar el modelo de IA

Abra dos terminales:

# Terminal 1: iniciar el servidor Ollama
ollama serve

# Terminal 2: descargar el modelo Mistral (~4.4 GB)
ollama pull mistral

💡 ¿No quiere descargar 4 GB?

Puede usar el modo cloud con GitHub Models o Gemini (gratuitos). Cambie BRAIN_MODE = "cloud" en config.py y configure una API Key.

Ejecutar JARVIS

python main.py

Se abrirá la ventana HUD con el tema Arc Reactor (cyan). ¡JARVIS está listo!

También puede ejecutarlo sin console con el archivo JARVIS.pyw (doble clic) o JARVIS.bat.

✅ ¡Instalación completada!

Continúe a Primera ejecución para aprender a usar la interfaz y dar su primer comando.

📂 Estructura del proyecto

JARVIS/
├── main.py                   # Punto de entrada
├── config.py                 # Configuración global
├── requirements.txt          # Dependencias
├── core/                     # Núcleo del sistema
│   ├── brain.py              # Conexión con el LLM
│   ├── voice_input.py        # Reconocimiento de voz
│   ├── voice_output.py       # Síntesis de voz (TTS)
│   ├── command_parser.py     # Detección de intenciones
│   ├── orchestrator.py       # Orquestador central
│   └── autonomous.py         # Agente autónomo
├── modules/                  # Módulos funcionales
│   ├── system_control.py     # Control del sistema, OCR
│   ├── web_search.py         # Búsquedas en Google
│   ├── file_manager.py       # Gestión de archivos
│   ├── document_processor.py # Documentos (PDF, Word...)
│   ├── email_manager.py      # Email
│   ├── code_executor.py      # Ejecutar código
│   ├── automation.py         # Automatización
│   ├── memory.py             # Memoria persistente
│   └── media_control.py      # Multimedia
├── ui/                       # Interfaz gráfica
│   ├── hud.py                # Ventana HUD principal
│   ├── styles.py             # Estilos (tema Arc Reactor)
│   └── widgets.py            # Widgets personalizados
├── plugins/                  # Extensiones
└── data/                     # Datos (auto-generados)
    ├── memory.db             # Base de datos
    └── logs/                 # Logs del sistema

Anterior← Introducción SiguientePrimera ejecución →