Instalación y actualizaciones
La mayoría de los usuarios deben instalar el paquete de escritorio de GitHub Releases. Los colaboradores, o cualquier persona que pruebe el código más nuevo, pueden ejecutar la aplicación de la fuente. El cliente de escritorio Electron se conecta a un backend Node compartido, que también sirve la interfaz autenticada del navegador local.
Paquetes actuales: v1.0.5 Assets incluyen instaladores de escritorio, archivos CLI independientes y Linux CLI .deb/.rpm paquetes. Elija el tipo de instalación y arquitectura previstos, a continuación, verifique la suma de comprobación de la misma versión. El lanzador de escritorio sigue disponible a través de Settings → General → Command line tool → Install command.
Elija un método de instalación
Descargar un instalador de escritorio
- Abre Open-Science Releases.
- Descargue el paquete que coincida con su sistema operativo y la arquitectura de CPU.
- Lea la licencia mostrada por el instalador y la instalación completa, a continuación, inicie la aplicación. Un mago de montaje de cinco pasos se abre en la primera carrera.
- Si el sistema operativo bloquea una aplicación no firmada, descarguela de nuevo del repositorio oficial AIPOCH GitHub y siga el aviso de seguridad de la plataforma sólo después de comprobar la fuente.
Elija desde el Activos conectado a la liberación, no el código fuente generado automáticamente ZIP. La disponibilidad depende de los activos publicados de esa publicación.
| Computadora | Identificar la arquitectura | Paquete e instalación |
|---|---|---|
| macOS, Apple Silicon | Acerca de este Mac muestra un chip de la serie M de Apple | Elija mac-arm64.dmg; abrirla, arrastrar la aplicación a Aplicaciones, luego lanzarla allí |
| macOS, Intel | Acerca de este Mac muestra un procesador Intel | Elija mac-x64.dmg; instalar en Aplicaciones. La aplicación requiere macOS 12 o posterior |
Instalar con Homebrew
También puede instalar con Homebrew:
brew install --cask open-science
Homebrew selecciona Apple Silicon o Intel automáticamente. Después de la instalación, abra Settings → General → About y confirme la versión instalada; un gestor de paquetes puede resolver una versión más reciente que la base de documentación. Instrucciones de instalación etiquetadas.
Los instaladores oficiales de Windows se firman con código desde v0.33.2; v0.33.3 extiende la firma a los ejecutables agrupados. Descargue desde el página oficial de descarga o GitHub Releases, y siga las notas oficiales de verificación para comprobar la fuente del paquete.
| Computadora | Identificar la arquitectura | Paquete e instalación |
|---|---|---|
| Windows | Ajustes → Sistema → Acerca → Tipo de sistema | Elija la coincidencia win-…-setup.exe; ejecutar el instalador de usuario actual y seguir sus indicaciones de ubicación |
- Abra el instalador Windows descargado y proceda a la página de instalación-ubicación.
- Mantenga la ubicación predeterminada o seleccione Browse… para elegir una carpeta para la aplicación, a continuación, seleccione Install.
- Espera la página de finalización. Deja la opción de lanzamiento seleccionada y elige Finish para abrir Open-Science.
- Siga Configuración de primera vez para comprobar el entorno y configurar la ubicación de datos, agente y modelo.
| Computadora | Identificar la arquitectura | Paquete e instalación |
|---|---|---|
| Ubuntu / Debian | uname -m: x86_64 significa x64, aarch64 significa ARM64 | Elija la coincidencia .deb, abrirlo con el instalador de paquetes del sistema, luego lanzar desde el menú de aplicación |
| Otras distribuciones Linux apoyadas | Check uname -m | Elija la coincidencia .AppImage, permitir la ejecución en los permisos del archivo, y luego abrirlo; resolver cualquier error de dependencia reportado por la distribución |
v1.0.5 proporciona Linux x64 y ARM64 paquetes. Para ARM64, seleccione aipoch-open-science-1.0.5-linux-arm64.AppImage o aipoch-open-science_1.0.5_arm64.deb. Los contrapartes x64 son aipoch-open-science-1.0.5-linux-x86_64.AppImage y aipoch-open-science_1.0.5_amd64.deb. Descarga de los activos oficiales de la versión seleccionada y coincide con el resultado de uname -m.
La carpeta de instalación contiene la aplicación; Data location, en el asistente de configuración, contiene los archivos de investigación y los entornos de ejecución. Estas ubicaciones se configuran por separado. Después de instalar, continúe con la configuración inicial.
Use el CLI independiente
Para una instalación terminal/browser, descargue un archivo CLI independiente a juego v1.0.5. It packs Node, the backend and Web UI. Extraiga el directorio completo, luego siga CLI setup. Mantenga el CLI y backend de la misma instalación juntos.
Homebrew CLI
Instala o administra el CLI de Homebrew con brew install aipoch/tap/open-science, por separado de la carcasa de escritorio. Revise la versión realmente ofrecida por Homebrew; la fórmula puede retrasarse detrás de una liberación de GitHub. La instalación no inicia un servicio de sistema. Si los lanzadores entran en conflicto, inspeccionen type -a open-science y uso "$(brew --prefix aipoch/tap/open-science)/bin/open-science" para esa instalación.
Paquetes Linux CLI
Para el uso terminal/browser de Linux, elija open-science-cli, separado del aipoch-open-science paquete de escritorio. Descargar el paquete y CLI-PACKAGE-SHA256SUMS.txt desde v1.0.5 Assets, luego verificar antes de instalar.
| Distribución / arquitectura | v1.0.5 Activo CLI |
|---|---|
| Debian / Ubuntu, x64 | open-science-cli_1.0.5_amd64.deb |
| Debian / Ubuntu, ARM64 | open-science-cli_1.0.5_arm64.deb |
| Fedora, x64 | open-science-cli-1.0.5-1.x86_64.rpm |
| Fedora, ARM64 | open-science-cli-1.0.5-1.aarch64.rpm |
Instala el archivo descargado con el administrador de paquetes adecuado. Estos ejemplos utilizan x64; utilice el nombre de archivo ARM64 cuando corresponda.
# Debian / Ubuntu
sudo apt install ./open-science-cli_1.0.5_amd64.deb
# Fedora: use this instead of the apt command
sudo dnf install ./open-science-cli-1.0.5-1.x86_64.rpm
Corre open-science-cli start --no-open, luego open-science-cli status --json. Una vez que se ejecuta, utilice open-science-cli url para abrir la interfaz web local autenticada; mantener esa URL privada. Continúe con CLI setup para la configuración del modelo y los cheques doctor, reemplazando open-science con open-science-cli en esos comandos.
Los paquetes de Node, el backend y la interfaz de usuario web. No instala Python/R ni crea un servicio de sistema iniciado automáticamente. Los requisitos de la tienda y de la caja de arena de OS todavía se aplican; ver credenciales de Linux sin cabeza. Utilice open-science-cli explícitamente cuando un lanzador de escritorio también está instalado.
Antes de actualizar o eliminar el paquete, terminar el trabajo y detener cada perfil iniciado por ese paquete. Instala el siguiente paquete descargado a través de apt/dnf; no hay un repositorio AIPOCH apt/dnf configurado por esta instalación. La eliminación de paquetes conserva datos de investigación y credenciales. El guía oficial del paquete describe conflictos de comandos y requisitos de plataforma.
Huir de la fuente
Necesita Git, Node.js 24, npm, y la plataforma construye requisitos para Electron. Instala o selecciona un marco de agente en la aplicación. Durante la instalación, el repositorio genera el Cliente Prisma, aplica parches de aplicaciones y prepara dependencias nativas de Electron.
Para una instalación de fuente reproducible, elija la etiqueta de liberación prevista de Cambio antes de instalar dependencias. Un clon predeterminado sigue la rama en lugar de una liberación fija. Grabar las versiones seleccionadas de etiqueta, fuente commit y tiempo de ejecución para que otra persona pueda reproducir el ambiente.
Reemplazar RELEASE_TAG abajo con la etiqueta exacta mostrada en la versión seleccionada (incluyendo su v) líder. Para seguir el desarrollo en curso, omitir --branch RELEASE_TAG --depth 1; que el checkout seguirá la rama predeterminada.
git clone --branch RELEASE_TAG --depth 1 https://github.com/aipoch/open-science.git
cd open-science
npm install
npm run dev
Antes de empaquetar una producción, ejecute:
npm run build
Utilice el paquete de la etiqueta seleccionada.json y guía de tiempo libre por sus objetivos y dependencias de construcción. npm run dev:web desarrolla el punto de entrada Node/Web; npm run dev también prepara al cliente de escritorio. Utilice un directorio de configuración aislado para mantener los datos de prueba separados.
Configuración completa por primera vez
Servicios externos y plazos de ejecución
| Capacidad | ¿Obligatorio? | Propósito |
|---|---|---|
| OpenCode, Claude Agent, Codex, o CodeBuddy | Al menos uno | Dirige sesiones de agente de conversación |
| Acceso modelo | Necesario para solicitudes de agentes | Una suscripción compatible o proveedor de API; acceso a la suscripción no requiere una tecla API separada |
| Python o R | Facultativo | Ejecuta el código de cuadernos; utilizar un entorno de sistema detectado o un entorno gestionado por aplicaciones |
| Acceso a la red | Recomendado | Instala tiempo de ejecución y conecta proveedores, GitHub, servicios remotos y conectores MCP |
| SSH host | Facultativo | Ejecuta trabajos remotos y recupera resultados a través del panel Compute |
Datos locales
El asistente de configuración muestra la ubicación de datos gestionados para archivos de investigación grandes como artefactos, archivos Notebook y entornos. Los ajustes de aplicación y el historial de conversaciones permanecen en la ubicación de configuración. Moving the research data location is not a complete application backup. Mantenerlo separado del repositorio de origen; use Almacenamiento para reubicarlo en lugar de mover archivos internos manualmente mientras la aplicación se ejecuta.
Confirme que la aplicación está lista
La aplicación se abre, el paso de verificación de entorno requerido, un agente se instala, y el acceso modelo se verifica. La configuración Python/R solo se requiere para trabajos que ejecuten esos idiomas. Abrir una vista previa CSV o PDF no valida un tiempo de ejecución Notebook. Siga Configuración de primera vez, luego Proveedor y configuración del modelo local.
Comprobar actualizaciones de la aplicación
En Settings → General → About, lee la versión instalada y utilice Check now para comprobar la disponibilidad de actualización. Inspeccione la versión listada antes de instalarla, y termine el trabajo activo primero. Una fuente de desarrollo puede reportar actualizaciones de forma diferente de una instalación envasada. Mantenga una copia de los resultados exportados importantes antes de una actualización; no renombrar los directorios de datos internos de la aplicación.
Desde 1.0, open-science update es eliminado. Actualice la aplicación a través de sus controles de escritorio o instalador oficial, y actualice una instalación CLI a través del administrador de instalador/paquete que la posee. Si Check now aún no ofrece una versión publicada, compruebe la página oficial de lanzamiento; Eliminar la configuración o restablecer la aplicación no promoverá un canal de actualización.
Si aparece Instale Open-Science antes de actualizar, la aplicación se ejecuta desde una ubicación de sólo lectura. Elija Instalar en Aplicaciones, o mueva la aplicación allí en Finder. Después de la instalación, utilice Reiniciar o deje de copiar y vuelva a abrir el que está en Aplicaciones, a continuación, consulte las actualizaciones de nuevo. Seguir usando mantiene abierta la copia actual; no hace que esa ubicación sea actualizable. Si la instalación falla, siga el error mostrado antes de reintentar.
La reinstalación conserva los datos existentes. Si usted necesita deliberadamente un nuevo comienzo después de un problema de datos, vea Reiniciar los datos locales Windows. Esta herramienta separada elimina los datos; no es parte de una actualización ordinaria.
Instalación de solución de problemas y puesta en marcha
| Donde falla | Primeros cheques |
|---|---|
| Instalación de escritorio o lanzamiento de aplicaciones | Compruebe la fuente del paquete, OS y la arquitectura de CPU, a continuación, lea el indicador del sistema operativo. |
| Instalación de fuentes | Confirmación node --version y npm --version, y eso npm install completado. Ingrese una instalación de dependencia interrumpida. |
| configuración inicial | Lea la comprobación del entorno fallida y resuelva su requisito declarado antes de continuar. |
| Primera solicitud de agente | Confirme un agente activo/acústico y corra Test connection en la página Modelo. |
| Proveedor o conexión del navegador local | Inspeccione el error de puerto, proxy o certificado reportado; ver Solución de problemas. |
Nombre del producto después de v0.31.0
La interfaz actual y los nuevos paquetes utilizan Open-Science de forma consistente. Actualizar preserva los nombres de instalación y ubicaciones existentes, datos de investigación, credenciales y ajustes. Un camino de instalación más antiguo que contiene Open Science no es por sí mismo un fallo de actualización; no renombrar o mover sus carpetas de datos para que coincida con el nuevo nombre de la pantalla.
Actualizar a 1.0 y entender la compatibilidad
- Terminar la investigación activa y respaldar el directorio de configuración más cualquier ubicación de datos configurada por separado. Una exportación
.scienceno es una copia de seguridad de todo el perfil. - Cerrar instancias de escritorio/backend utilizando la instalación, luego actualizar a través del instalador oficial. Preserve el perfil original, los datos y la tienda de credencial OS.
- Reabrir y comprobar la versión, proyectos, sesiones, archivos, modelo y tiempos de ejecución antes de continuar. Una bajada binaria no retrocede los datos; Los binarios antiguos no pueden leer datos guardados más nuevos.
1.0 conserva las rutas históricas de actualización e importación existentes; el número de versión no requiere un reajuste de perfil. El 1.x política de compatibilidad cubre las interfaces de CLI/SDK y de automatización de tareas documentadas, las importaciones futuras de válidas .science paquetes y actualizaciones de perfiles compatibles. No garantiza respuestas modelo idénticas, disponibilidad de terceros o reproducción determinista de toda una sesión de investigación, o transferencia multiplataforma de credenciales protegidas por el sistema operativo. Seguridad fija el objetivo de la última liberación estable.
Instala el CLI con npm
Use Node.js 22.13 o más tarde para el paquete CLI/backend publicado. En un terminal, instalar e inspeccionar la versión invocada:
npm install --global @aipoch/[email protected]
open-science version --json
open-science help
Entonces sigue. terminal setup para inicializar un perfil, iniciar su backend y configurar un modelo. La instalación por sí sola no lo registra ni instala Python/R. Si un lanzador de escritorio o Homebrew ya utiliza el mismo nombre de comando, inspeccione qué ejecutable su shell selecciona antes de continuar. Detener todos los backend que posean una instalación antes de actualizar esa instalación; conservar su perfil y actualizar a través de su original gestor de paquetes.
Siga una actualización hasta la instalación
In Settings → General → About, elegir Check now y revisar la liberación ofrecida. El diálogo de actualización mantiene el progreso de descarga, notas de lanzamiento y preparación de la instalación juntos. La finalización de la descarga no es la terminación de la instalación: verifique la versión instalada después del relanzamiento.
Si la aplicación dice que la instalación automática no está disponible para este canal, mantenga el paquete descargado y utilice el instalador oficial después de terminar el trabajo activo. Los canales de instalación v1.0.5 todavía restringen el reemplazo automático; un diálogo mejorado de progreso de Windows no elimina esa restricción. No obligue a la aplicación cerrada mientras la limpieza de cuadernos está en progreso.
Instalar una actualización manualmente
En el diálogo de actualización, abierto Installation instructions. Uso Download from website si no tienes un paquete. Para un instalador descargado confirmado, elija Show in Finder, Show in File Explorer o Show in file manager, dependiendo de la plataforma. Mantenga la carpeta abierta mientras deja la aplicación.
Guardar el trabajo y esperar la instalación o limpieza activa para terminar antes de comenzar otro instalador. En macOS, abre el DMG o descomprime el paquete y reemplaza Open-Science in Applications. En Windows, ejecute el instalador usando la carpeta de instalación existente. En Linux, instale el DEB correspondiente o reemplace la AppImage y conserve el permiso ejecutable. Siga las instrucciones para su formato de paquete real.
Si el instalador está desaparecido o ha cambiado, descargarlo de nuevo; revelar un paquete no lo ejecuta. Reabrir Open-Science y comprobar Settings → General → About, luego confirme sus proyectos y datos originales. Al actualizar archivos independientes CLI, primero verificar que todos los servicios afectados han dejado de.