ODYSSEUSInstalar

Sistema en línea · v1.0 · local-first

ODYSSEUS

Tu investigador autónomo, en tu propio hardware. Busca, recuerda y actúa — sin que tus datos salgan de tu máquina.

Elige tu sistema abajoGratis · MIT · sin cuenta

  • 3sistemas
  • 104líneas de instalador, léelas
  • 127.0.0.1corre en tu máquina
Desplázate

02 — Protocolo de instalación

Tres pasos. Una línea.

Pega una línea en tu terminal — en Windows, haz doble clic en un archivo. El instalador prepara todo y puedes repetirlo cuando quieras para reparar o actualizar.

  1. Abre Terminal

    Pulsa ⌘ Espacio, escribe «Terminal» y pulsa Enter.

  2. Pega la línea y pulsa Enter

    Instala las herramientas de Xcode y Python 3.12 si faltan y clona Odysseus en ~/odysseus.

  3. Responde al asistente

    Pide solo las llaves que faltan, con un enlace a la guía de cada una, guarda ~/odysseus/.env con permisos 600 y abre Odysseus en tu navegador.

listo

Recomendado pega esto en Terminal

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/LuisArmando-TestCoder/Odysseus/main/installer/bootstrap/install-macos.sh)"

Descarga el instalador de la rama main por HTTPS y lo ejecuta. Te pedirá tu contraseña solo si hace falta instalar herramientas del sistema.

O descarga el archivo

install-macos.sh4.7 KB
bash ~/Downloads/install-macos.sh
Verifica antes de ejecutar104 líneas · 4.7 KB

SHA-256 de install-macos.sh

83e9849110dab3e65f7ca79cfbd3423fbb7e034b8250e2afb8a590afe2b14db7

Compáralo con

shasum -a 256 ~/Downloads/install-macos.sh
Leer el código en GitHub

macOS 12+ · instala las herramientas de Xcode y Python 3.12 si faltan

Lo que verás · macOS · abreviado

  1. ▶ Odysseus — macOS installer
  2. install folder: ~/odysseus
  3. ✓ git: git version …
  4. ✓ Python: Python 3.12 …
  5. Cloning https://github.com/LuisArmando-TestCoder/Odysseus.git …
  6. ▶ Running the Odysseus installer…
  7. ✓ venv creado
  8. ✓ Dependencias instaladas
  9. Cada variable muestra enlaces de tutorial…
  10. ✓ .env escrito en ~/odysseus/.env (permisos 600)
  11. Esperando a que el servidor responda (la primera vez puede tardar ~1-2 min)…
  12. ✓ Odysseus está corriendo en http://127.0.0.1:7860
  13. Listo. Puedes cerrar esta terminal.

Al terminar

http://127.0.0.1:7860

Odysseus se abre en tu navegador y queda un acceso directo para abrirlo y detenerlo. Nada sale de tu máquina salvo las llamadas a los modelos o servicios que tú configures.

¿Algo no salió bien?

03 — Módulos

Un asistente, seis sistemas.

Todo corre en tu máquina. Tú decides qué modelos usar y qué sale a internet.

04 — Ayuda

Antes de que lo preguntes.

Lo que suele pasar la primera vez, y cómo actualizar, mover o quitar Odysseus.

Cómo funcionan las actualizaciones
¿Es seguro pegar un comando de internet?

Lee el instalador antes de ejecutarlo: el código está en el repositorio y esta página publica su SHA-256. La línea descarga exactamente ese archivo desde la rama main de GitHub por HTTPS, y todo el script vive dentro de una función, así que una descarga cortada nunca se ejecuta a medias.

¿Dónde se instala?

En ~/odysseus (en Windows, %USERPROFILE%\odysseus). Para usar otra carpeta, define ODYSSEUS_HOME antes de ejecutarlo. Si la carpeta ya existe y no es una instalación de Odysseus, el instalador se detiene sin tocarla.

export ODYSSEUS_HOME=/ruta/que/prefieras
macOS me pide instalar las herramientas de línea de comandos

Es normal la primera vez: haz clic en Instalar en el diálogo del sistema. El instalador espera hasta que terminen y continúa solo. Si Homebrew pide tu contraseña, es para instalar Python 3.12.

Windows SmartScreen bloquea el archivo

Elige Más información → Ejecutar de todas formas. Si prefieres no descargar nada, pega la línea de PowerShell de la pestaña Windows: hace lo mismo.

¿Cómo se actualiza?

Revisa la rama main cada hora y al iniciar sesión (launchd en macOS, cron en Linux, Tarea programada en Windows). Si una actualización no pasa la comprobación de salud, vuelve a la versión anterior. Ejecutar el instalador otra vez repara la instalación sin borrar tus datos.

El puerto 7860 está ocupado

Cierra el programa que lo usa, o define otro puerto en tu .env y vuelve a abrir Odysseus.

APP_PORT=7861
¿Puedo instalarlo sin preguntas (servidor, CI)?

Sí. Descarga el archivo y pásale --non-interactive: usa el .env que ya tengas y se salta el asistente.

bash install-linux.sh --non-interactive
¿Cómo lo desinstalo?

Desde la carpeta de instalación, el desinstalador detiene Odysseus y quita la actualización programada, el inicio con sesión y los accesos directos. Tu código, tu .env y data/ se quedan: bórralos tú si quieres quitarlo todo (haz copia antes).

python installer/uninstall.py

05 — Activación

Enciende tu propio Jarvis.

Instalar Odysseus

Elige tu sistema abajo · Sin cuenta · Se actualiza solo