← Volver a inicio
valle studio os · manual express 01
Manual de Instalación
Express

Convierte tu laptop en un sistema IA operativo. Sin servidores, sin conocimientos previos, sin pagar suscripciones. Solo tu máquina, una tarde y este manual.

lo que vas a construir
Hermes Agent + Telegram
= Tu sistema IA vivo

En las próximas 16 páginas vas a transformar una laptop común en un sistema operativo IA completo. Tu agente correrá en local, recordará quién eres entre sesiones, tendrá acceso a 60+ herramientas y podrás hablarle desde Telegram estés donde estés.

  • 01Setup: terminal, Python, Git, editor listo
  • 02Hardware: Linux Mint instalado y configurado
  • 03Hermes: agente instalado, conectado a LLM, respondiendo
  • 04Telegram: bot activo, agente en tu bolsillo
módulo 0 · setup
Todo empieza en la terminal

Antes de instalar cualquier cosa, tu máquina necesita las herramientas base. Si ya tienes Linux, esto te toma 5 minutos. Si vienes de Windows o macOS, el Módulo 1 te instala Linux Mint primero.

  • 01sudo apt update && sudo apt upgrade -y — sistema al día
  • 02python3 --version — verifica Python 3.10+
  • 03sudo apt install python3-pip git -y — pip + git
  • 04pip install --upgrade pip — pip actualizado

Herramientas base instaladas. Pasamos al hardware.

módulo 0 · herramientas
Configura Git y tu editor de código

Dos herramientas que usarás constantemente: Git para versionar tu vault y un editor para ver y modificar archivos sin terminal.

  • 01git config --global user.name "Tu Nombre"
  • 02git config --global user.email "tu@email.com"
  • 03Instalar VS Code: sudo snap install code --classic
  • 04Probar editor: code ~/
Tip: No uses nano si no lo conoces. VS Code te da interfaz gráfica, explorador de archivos y terminal integrada. Es tu escritorio de trabajo del sistema IA.
módulo 1 · hardware
Tu laptop vieja es más capaz de lo que crees

No necesitas una GPU de $2,000 USD. Linux Mint corre en máquinas de 10+ años. La única inversión real: un SSD de 240 GB (desde $15.000 CLP) que acelera todo.

Componente Mínimo Recomendado
RAM 4 GB 8 GB
Disco HDD 120 GB SSD 240 GB+
Procesador Intel Core 2 Duo Intel i5 / AMD Ryzen
SO actual Windows / macOS / Linux Cualquiera
Inversión extra $0 $15.000-$25.000 (SSD)
módulo 1 · linux mint
Linux Mint en 20 minutos, sin complicaciones

Linux Mint Xfce es ligero, estable y su interfaz se parece a Windows. No necesitas saber comandos para instalarlo. El instalador es gráfico: 10 clics y estás dentro.

  • 01Descargar ISO: linuxmint.com (edición Xfce para equipos ligeros)
  • 02Crear USB booteable: Balena Etcher (gratis, multi-plataforma)
  • 03Bootear: reinicia, presiona F12/DEL/ESC, selecciona USB
  • 04Instalar: sigue el asistente gráfico (~10 clics, particionado automático)
  • 05Actualizar: sudo apt update && sudo apt upgrade -y

Linux Mint instalado. Terminal lista. Vamos por Hermes.

módulo 1 · configuración
Deja tu sistema listo para producir

Tres configuraciones que marcan la diferencia entre un Linux básico y un servidor IA doméstico.

  • 01Firewall: sudo ufw enable && sudo ufw allow ssh
  • 02SSH: sudo apt install openssh-server (acceso remoto)
  • 03Apagado automático: sudo systemctl suspend para ahorrar energía
  • 04Drivers: sudo apt install mint-meta-codecs (multimedia)
Tip: Si tu laptop tiene 4 GB de RAM, considera una partición swap de 4 GB durante la instalación de Mint. El sistema IA funciona, pero con 8 GB+ es otra experiencia.
módulo 2 · hermes agent
El corazón de tu sistema operativo IA

Hermes Agent, creado por Nous Research, es el agente open-source más avanzado disponible. 90.000+ estrellas en GitHub. MIT License. Corre en tu máquina, no en la nube de nadie.

  • 01Memoria persistente: recuerda quién eres entre sesiones
  • 0260+ herramientas nativas: archivos, web, imágenes, código, terminal
  • 03Model-agnostic: usa OpenAI, Anthropic, Google, o el que quieras
  • 04Multi-plataforma: Telegram, Discord, terminal, web
módulo 2 · instalación
Una línea de comando y todo empieza a funcionar

Hermes se instala con pip. Sin compilación, sin dependencias manuales, sin bases de datos que configurar.

  • 01pip install hermes-cli — instala el agente
  • 02hermes setup — configura el entorno base
  • 03hermes status — verifica que todo está bien
  • 04Configurar proveedor LLM (siguiente página)
  • 05hermes ask "¿Quién eres?" — primer diálogo con tu agente
módulo 2 · proveedor llm
Conecta el cerebro de tu sistema

OpenRouter te da acceso a decenas de modelos LLM con una sola API key. Sin vendor lock-in: empiezas con un modelo gratuito y escalas cuando quieras.

  • 01Ve a openrouter.ai/keys y crea una API key
  • 02Ejecuta: hermes config set openrouter_api_key "sk-..."
  • 03Verifica: hermes status debe mostrar el proveedor como "connected"
  • 04Prueba: hermes ask "¿Qué modelos tienes disponibles?"
Tip: Para empezar sin gastar: usa google/gemini-2.0-flash-exp:free (gratis, 10 RPM). Cuando necesites más potencia, cambias a Claude o GPT-4 con un solo comando.
módulo 2 · verificación
Tu agente responde por primera vez, en tu máquina

Ejecutas hermes ask "¿Qué puedes hacer por mí?". El agente responde. No es un chatbot web. No es un SaaS. Es tu agente, corriendo en tu laptop, en Linux, en la máquina que tenías guardada en un cajón.

Checklist de verificación

  • hermes --version devuelve un número de versión
  • hermes status muestra "online" con proveedor conectado
  • Primer prompt respondido correctamente
  • El agente recuerda tu nombre en la segunda pregunta

Hermes está vivo en tu máquina. Pasamos a la conexión definitiva.

módulo 3 · telegram
Tu agente, ahora en tu bolsillo

Conectar Hermes a Telegram significa que puedes hablarle desde el celular, recibir respuestas, ejecutar tareas y automatizar procesos sin estar frente al ordenador. Es el paso que convierte un agente local en un sistema operativo portátil.

  • 01Abre Telegram, busca @BotFather y escribe /newbot
  • 02Elige un nombre y username para tu bot
  • 03BotFather responde con un token: 123456:ABC-DEF...
  • 04Configura en Hermes: hermes config set telegram_bot_token "..."
  • 05Inicia el bot: hermes gateway start
módulo 3 · bot activo
Gateway iniciado. Tu agente te espera en Telegram

El gateway de Hermes funciona como un puente: recibe mensajes de Telegram, los pasa al agente, y te devuelve las respuestas. Sin intermediarios, sin latencia de servidores externos.

  • 01Abre Telegram, busca tu bot por el username que creaste
  • 02Escribe /start — el bot responde con una bienvenida
  • 03Pregunta: "¿Qué puedes hacer por mí?"
  • 04El agente responde desde tu laptop, en tiempo real
  • 05Gateway corre 24/7: puedes usar systemd para que arranque solo

Tienes un agente IA corriendo en tu máquina, accesible desde cualquier parte del mundo vía Telegram. Bienvenido a tu sistema operativo IA.

sistema completo
Todo instalado. Todo funcionando.

Marca cada paso completado. Cuando todos los ✓ estén verdes, tu sistema IA operativo está listo para producir.

  • Python 3.10+ instalado y verificado
  • Git configurado con usuario y email
  • VS Code instalado
  • Linux Mint instalado y actualizado
  • Firewall activo (UFW)
  • Hermes Agent instalado (hermes --version)
  • OpenRouter API key configurada y conectada
  • Primer prompt ejecutado y respondido
  • Bot de Telegram creado (@BotFather)
  • Gateway de Hermes corriendo y respondiendo en Telegram
faq · solución de problemas
Algo no funcionó? Aquí tienes la solución

Los problemas más comunes al instalar Hermes y conectarlo a Telegram. Si no encuentras tu caso, el curso completo tiene troubleshooting avanzado.

01 — pip: command not found
Solución: sudo apt install python3-pip e intenta de nuevo.
02 — OpenRouter da error 401 (Unauthorized)
Solución: Verifica que la API key esté bien copiada. hermes config get openrouter_api_key para confirmar.
03 — Hermes no responde en Telegram
Solución: Gateway debe estar corriendo. hermes gateway status. Si no, hermes gateway start.
04 — El bot en Telegram no aparece
Solución: Busca el username exacto que creaste con BotFather. Los bots no aparecen en búsquedas genéricas de Telegram.
05 — Linux Mint no bootea desde USB
Solución: Entra a BIOS (F2/DEL) y cambia el orden de boot. Desactiva Secure Boot.
06 — Error: externally-managed-environment
Solución: Usa pip install --break-system-packages hermes-cli o crea un entorno virtual con python3 -m venv ~/hermes-env.
próximo paso
Tienes el sistema. Ahora construye el futuro.

En una tarde pasaste de cero a tener un sistema IA operativo con Hermes corriendo en local y Telegram conectado. El curso completo de Valle Studio OS te da las siguientes 8 semanas para convertir ese motor en una máquina de automatización total.

  • 01Setup profesional: terminal, permisos, perfiles
  • 02Hardware: Linux Mint, SSD, redes, seguridad
  • 03Hermes: instalación, proveedores, configuración avanzada
  • 04Vault: estructura, memoria, patrones, routing
  • 05Skills: módulos reutilizables, packs, optimización
  • 06Pipelines: carruseles, video, auditorías automatizadas
  • 07Optimización: tokens, contexto, recuperación ante fallos
  • 08Automatización: publicación multicanal programada
Accede al curso completo vallestudio.cl/curso