Instala ORCA
Una línea en Linux, macOS o Windows (WSL2). Puedes correrla de nuevo sin problema y nunca necesita sudo.
curl -fsSL https:/ / make.operio.work/ install.sh | bash Qué necesitas
- Linux (x86_64 o arm64), macOS (Apple silicon o Intel), o Windows con WSL2.
- Hasta ahora lo probamos en Linux. macOS y WSL2 siguen los mismos pasos, pero aún no los hemos probado; cuéntanos en GitHub si algo falla.
- Node.js 20 o más reciente.
- Un asistente de IA instalado y con sesión iniciada: Claude Code, Codex u opencode.
- Una computadora que esté prendida a la hora de tus rutinas.
Instalación
curl -fsSL https:/ / make.operio.work/ install.sh | bash Luego abre http://127.0.0.1:7171
Qué hace el instalador
- Descarga el panel y herdr 0.9.5, el espacio de trabajo de terminal de código abierto sobre el que corre, y revisa la descarga contra una suma de verificación fija.
- Instala en ~/.local/share/operio-orca y deja el comando operio-orca en ~/.local/bin.
- Lo arranca con tu computadora: un servicio de usuario de systemd en Linux, un agente de launchd en macOS. Agrega --no-service para omitirlo.
- Agrega las cinco rutinas gratis, apagadas hasta que las actives.
¿Prefieres leerlo antes?
Descarga el script, léelo y luego córrelo. O clona el repositorio y córrelo desde ahí.
curl -fsSLo install.sh https:/ / make.operio.work/ install.sh
less install.sh
bash install.sh git clone https:/ / github.com/ operio-work/ orca
cd orca && bash install.sh Windows (WSL2)
En Windows, ORCA corre dentro de WSL2, el sistema Linux que viene con Windows. Lo configuras una vez y luego usas la misma instalación de una línea.
- Abre PowerShell como administrador, instala WSL2 con Ubuntu y reinicia si Windows te lo pide:
wsl --install -d Ubuntu - Abre Ubuntu desde el menú Inicio y crea tu usuario. Dentro de Ubuntu, instala Node.js 20 o más reciente y tu asistente de IA.
- Corre la misma instalación de una línea dentro de Ubuntu:
curl -fsSL https:// make.operio.work/ install.sh | bash
Que arranque con Ubuntu
Las instalaciones nuevas de WSL2 traen systemd apagado, así que el instalador arranca ORCA a mano y muestra esta receta. Activa systemd una vez, reinicia WSL y corre de nuevo la línea de instalación: desde entonces ORCA arranca con Ubuntu.
- En Ubuntu:
printf '[boot]\nsystemd=true\n' | sudo tee -a /etc/ wsl.conf - En PowerShell:
wsl --shutdown - Abre Ubuntu de nuevo y corre la línea de instalación otra vez:
curl -fsSL https:// make.operio.work/ install.sh | bash
El soporte para WSL2 es nuevo. Si algo no funciona, cuéntanos en GitHub.
Úsalo desde tu celular
ORCA escucha solo en 127.0.0.1. Déjalo así y entra con una de estas opciones.
Tailscale (red privada, HTTPS)
- Comparte el panel dentro de tu red privada:
tailscale serve --bg 7171 - Agrega el nombre que muestra a ~/.config/operio-orca/env:
OPERIO_ORCA_ALLOWED_HOSTS=<machine>.<tailnet>.ts.net - Reinicia y abre ese nombre en tu celular:
operio-orca restart
Las alertas en el celular necesitan HTTPS, así que esta es la forma de tenerlas.
Túnel SSH
Desde el dispositivo que quieres usar; luego abre http://127.0.0.1:7171 en él:
ssh -N -L 7171:127.0.0.1:7171 you@this-computer Nunca lo expongas a internet: sin reenvío de puertos, sin enlaces públicos. No tiene inicio de sesión, así que quien lo alcance lo puede usar.
Comandos del día a día
operio-orca status- Si está corriendo, y dónde
operio-orca restart- Reinicia después de cambiar la configuración
operio-orca stop- Lo detiene hasta que lo inicies de nuevo
operio-orca start- Lo inicia de nuevo
operio-orca open- Lo abre en tu navegador
operio-orca doctor- Revisa la instalación y muestra cómo arreglar lo que falle
operio-orca logs- El registro del panel (logs herdr, logs routines; -f para seguirlo)
operio-orca backup- Guarda configuración, rutinas, borradores y bitácora en un archivo
operio-orca restore ARCHIVO- Regresa un respaldo (conserva una copia de lo que había)
operio-orca llm set NOMBRE- Guarda una clave de API para tus agentes (oculta al escribirla o por tubería, nunca como argumento)
operio-orca llm list- Las claves guardadas, por nombre y últimos 4 caracteres (llm unset NOMBRE quita una)
operio-orca llm apply- Reinicia herdr para que los agentes reciban las claves (solo si ninguno está trabajando)
operio-orca llm test claude- Una prueba mínima con las claves cargadas: ok, o por qué no (claude, codex, opencode, gemini)
¿Por qué operio-orca y no solo orca? Ubuntu y muchos escritorios Linux ya traen un programa llamado orca: el lector de pantalla de GNOME. Un nombre distinto evita que se confundan.
Actualizar
operio-orca update Actualiza el panel y herdr juntos, a versiones probadas entre sí. Úsalo en lugar de actualizar herdr por separado.
Para solo ver si hay una versión nueva, sin instalar nada:
operio-orca update --check Prueba la demo
Un segundo panel en el puerto 7172 con dos negocios ficticios, Harbor Street Bistro y Brightside Dental. Sin datos reales, sin costo, y nunca toca tu propia configuración.
operio-orca demo- La inicia
operio-orca demo --lang es- La reproduce en español
operio-orca demo --reset- Empieza desde cero
operio-orca demo --stop- La detiene
Desinstalar
operio-orca uninstall Quita el panel y su servicio. Agrega --purge para borrar también tu configuración, borradores y registros en ~/.config/operio-orca. Tus asistentes de IA y su trabajo no se tocan.
¿Prefieres no correrlo tú?
Operio opera las rutinas por ti, conectadas a tus herramientas reales y vigiladas para que sigan funcionando.
Habla con Operio