Ir al contenido
APXAPX

Instalar

APX es un proceso en segundo plano, el core, más las apps que le hablan. Elegí cómo querés correrlo: la app de escritorio trae su propio core, una instalación de servidor corre el core sin pantalla, y desde el código corrés todo tal cual está.

Podés usar también el comando de instalación de la portada: en una computadora nueva con sesión gráfica instala y abre la app correspondiente a tu sistema y procesador. La app pregunta Servidor / Cliente antes de arrancar un core; este camino no registra un servicio. --desktop fuerza ese modo y --server instala el servidor directamente. Las instalaciones de servidor existentes conservan su modo al actualizarse.

Si ya usás APX en localhost sin app, el panel ofrece Instalar y abrir. Un clic descarga con progreso, verifica el archivo, instala la app y la abre usando los mismos datos, puerto y configuración. No tenés que repetir el asistente. Usá Minimizar para seguir trabajando mientras avanza. Cancelar detiene la descarga y permite reintentar. Cuando comienza la instalación, el sistema operativo la termina; si falla, el aviso vuelve a expandirse. Cerrar el aviso se recuerda al recargar y deja un acceso para instalar encima de tu usuario. Después de instalar, pasa a Abrir desktop. El aviso aparece solo en navegadores de computadora con conexión local directa y una sesión gráfica disponible. La instalación ocurre en la computadora donde corre APX; un túnel SSH transparente también parece local.

La app de escritorio es la forma más fácil de arrancar. Trae su propio core, el panel y el navegador que manejan tus agentes, y vive en la barra de menú o en la bandeja del sistema.

  1. Bajate el instalador para tu sistema desde los releases de APX v2. Elegí el v2.x.y más nuevo (los releases de v1 están en la misma lista):

    SistemaArchivo
    macOS, Apple siliconAPX-<versión>-mac-arm64.dmg
    macOS, IntelAPX-<versión>-mac-x64.dmg
    WindowsAPX-<versión>-win-x64.exe
    LinuxAPX-<versión>-linux-x64.AppImage (o -arm64)

  2. Instalala y abrila. Las apps todavía no están firmadas, así que tu sistema te avisa la primera vez (mirá más abajo).

    • macOS: abrí el .dmg y arrastrá APX a Aplicaciones. La primera vez, hacé clic derecho en APX dentro de Aplicaciones, elegí Abrir y otra vez Abrir. Si macOS solo te ofrece tirarla a la papelera, andá a Ajustes del Sistema › Privacidad y seguridad, bajá hasta el aviso sobre APX y tocá Abrir igualmente.
    • Windows: corré el .exe. Cuando SmartScreen diga que protegió tu PC, hacé clic en Más información y después en Ejecutar de todas formas.
    • Linux: hacé ejecutable el AppImage y abrilo: chmod +x APX-*.AppImage, después ./APX-<versión>-linux-x64.AppImage (o doble clic).

  3. En el primer arranque, APX te pregunta ¿Dónde corre tu APX?

    • Servidor: APX corre en esta computadora. El core se instala y arranca acá. Después elegís desde dónde lo vas a usar: Solo desde esta computadora (lo más seguro), También desde mi red local o Tailscale (tus dispositivos desde cualquier lado, por https; necesita Tailscale instalado).
    • Cliente: APX ya corre en otra máquina y esta app solo se conecta, por Dirección (su URL de Tailscale, por ejemplo) o por SSH como usuario@servidor. SSH usa tu propio ssh y tus claves: el core se queda en el servidor y no se abre ningún puerto. Un APX remoto te pide un código de emparejamiento, que sacás en esa máquina en Config › Dispositivos o con apx pair.

  4. Con un core local, después se abre el asistente de configuración. Seguilo en Primeros pasos.

Lo podés cambiar después desde el menú APX › Cambiar conexión.

Dónde viven tus datos

Sección titulada «Dónde viven tus datos»

Todo lo que guarda APX está en una carpeta, ~/.apx/v2 (con APX_HOME la movés). Tus proyectos se quedan donde están; APX solo les suma AGENTS.md y .apc/.

  • Directorio~/.apx/v2/
    • apx.db todo el estado: agentes, hilos, tareas, memoria, configuración (SQLite)
    • core.env el token del core, el host y la dirección pública, si los configurás
    • secrets.json los valores secretos, donde no se usa el llavero del sistema
    • Directorioskills/ tus skills globales
      • …
    • Directorioextensions/
      • …
    • Directorioprojects/ el lado de APX de cada proyecto, como sus widgets
      • …
    • Directoriomedia/
      • …
    • Directoriologs/
      • …
    • Directoriobackups/
      • …
    • Directorioapp/ el core instalado, en instalaciones de servidor
      • …

En macOS, los valores secretos van a tu llavero de sesión (Keychain); en el resto, a secrets.json con permisos solo para vos.

Actualizaciones

Sección titulada «Actualizaciones»

APX busca una versión nueva cada pocas horas y, cuando sale una, muestra una pastilla Actualización en la barra de arriba; ahí ves qué trae y actualizás cuando quieras.

  • App de escritorio: se actualiza sola. El AppImage y el instalador de Windows instalan la versión nueva por su cuenta; en macOS abre la imagen de disco nueva para que la arrastres.
  • Instalación de servidor: apx upgrade --check te dice si hay un release más nuevo, y apx upgrade lo instala al lado del que corre y reinicia. Una app de escritorio conectada al servidor también lo puede actualizar.
  • Checkout: APX sigue main del checkout desde donde corre; actualizar hace pull, instala, compila y reinicia.

Con APX_UPDATES=off se apagan los chequeos.

La primera vez que APX arranca en una versión nueva, tu super-agente abre un chat nuevo con lo que cambió, y una pastilla Ver cambios en la barra de arriba lo abre. Esas notas viajan con la versión, así que leerlas no gasta tokens y funciona sin conexión; solo preguntar sobre ellas en ese chat corre un turno. Las notas son los mensajes de los commits, así que ese chat está en inglés. Una instalación nueva arranca sin aviso, y APX_WHATS_NEW=off apaga el chat.

Cuando una versión trae algo que tu super-agente ahora puede hacer por vos (por ejemplo, actualizar tus widgets), te lo cuenta una vez, con sus palabras y en tu idioma, por tu canal preferido, con un botón por cada cosa que ofrece. Solo ese mensaje llama a un modelo, y solo cuando algo te aplica; a una instalación nueva no se le cuenta nada. APX_NEWS=off lo apaga, y apx news lista lo que hay.

Desinstalar

Sección titulada «Desinstalar»

Desinstalar saca el programa y su servicio. Tus datos quedan en ~/.apx/v2; borrá esa carpeta vos si querés empezar de cero. Los archivos de APX v1 en ~/.apx no se tocan en ningún caso.

Podés usar también el comando de instalación de la portada: en una computadora nueva con sesión gráfica instala y abre la app correspondiente a tu sistema y procesador. La app pregunta Servidor / Cliente antes de arrancar un core; este camino no registra un servicio. --desktop fuerza ese modo y --server instala el servidor directamente. Las instalaciones de servidor existentes conservan su modo al actualizarse.

Si ya usás APX en localhost sin app, el panel ofrece Instalar y abrir. Un clic descarga con progreso, verifica el archivo, instala la app y la abre usando los mismos datos, puerto y configuración. No tenés que repetir el asistente. Usá Minimizar para seguir trabajando mientras avanza. Cancelar detiene la descarga y permite reintentar. Cuando comienza la instalación, el sistema operativo la termina; si falla, el aviso vuelve a expandirse. Cerrar el aviso se recuerda al recargar y deja un acceso para instalar encima de tu usuario. Después de instalar, pasa a Abrir desktop. El aviso aparece solo en navegadores de computadora con conexión local directa y una sesión gráfica disponible. La instalación ocurre en la computadora donde corre APX; un túnel SSH transparente también parece local.

  • macOS: cerrá APX desde su ícono en la barra de menú y arrastrá APX de Aplicaciones a la papelera.
  • Windows: Configuración › Aplicaciones › Aplicaciones instaladas › APX › Desinstalar.
  • Linux: cerrá APX y borrá el AppImage.

Si además instalaste el core como servicio en esta computadora (apx service install, o una instalación de servidor), sacalo con apx service uninstall o con los pasos de servidor de la pestaña siguiente.

Convivir con APX v1

Sección titulada «Convivir con APX v1»