Repolode
Enviar
mengrru

mengrru/Spherse

Un runtime de escritorio local-first donde varios agentes de IA comparten una carpeta de proyecto, se ejecutan según horarios o eventos y dan vida a apps HTML interactivas.

Ver en GitHubSitio web
Estrellas
91
Forks
12
Issues abiertos
21
Último commit
hace 12 horas

¿Qué es?

Spherse es un runtime local para ejecutar agentes de IA sobre un directorio de proyecto compartido. Los archivos sin formato del proyecto sirven como datos del usuario, y cada agente puede tener su propio prompt de sistema, permisos de herramientas, skills privadas y compartidas, conexiones a servidores MCP, varias sesiones persistentes y temas de chat. Las sesiones se guardan en una base de datos SQLite dentro del proyecto, y la configuración de los agentes usa Markdown, YAML y JSON.

La automatización se gestiona mediante triggers que ejecutan agentes según una programación cron o en respuesta a eventos personalizados con payloads. Los eventos pueden provenir del usuario, de una página HTML o de otro agente. El servidor de vista previa integrado sirve archivos HTML, imágenes y otros archivos del proyecto, y un SDK de UI permite que esas páginas lean y escriban datos JSON, creen sesiones, envíen mensajes a los agentes y disparen eventos.

La aplicación de escritorio está desarrollada con Electron y React para macOS, Windows y Linux, y un cliente web protegido por token permite que los dispositivos móviles se conecten al runtime de escritorio. Se puede copiar o compartir toda la carpeta del proyecto como una unidad, incluidos sus datos, la configuración de los agentes, las skills, los triggers y las páginas.

Funciones clave

  • 01Varios agentes en un mismo proyecto, con prompts, permisos de herramientas, skills y conexiones MCP independientes
  • 02Triggers cron y de eventos personalizados que ejecutan agentes en sesiones nuevas o existentes
  • 03Servidor de vista previa HTML integrado con un SDK de UI para leer datos y controlar agentes
  • 04Almacenamiento local: archivos sin formato, configuración en Markdown/YAML/JSON y sesiones en SQLite
  • 05Apps de escritorio para macOS, Windows y Linux, además de un cliente web móvil protegido por token

Casos de uso

  • Mantener un mundo ficticio persistente o una experiencia de role-play interactiva con varios personajes
  • Crear un sistema personal de registro con dashboards y resúmenes diarios programados
  • Coordinar agentes de investigación, síntesis y archivado en una carpeta de conocimiento compartida
  • Crear herramientas HTML personalizadas que lean datos locales y envíen solicitudes a agentes

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/mengrru/Spherse.git
  2. 2

    Entra en la carpeta del proyecto

    cd Spherse
  3. 3

    Instala las dependencias

    npm install
  4. 4

    Inicia la aplicación en modo de desarrollo

    npm run dev

Antes de usarlo

  • El desarrollo local requiere Node.js 22.19 o posterior.
  • Necesitas una clave API de un proveedor de LLM compatible para poder crear agentes.
  • La versión para macOS no está firmada con un certificado de Apple Developer, por lo que macOS puede mostrar una advertencia al abrirla por primera vez.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCPHerramientas de privacidad y local-first

Temas

#ai-agent#local-first#electron#typescript#automation#roleplay#worldbuilding#mcp#ai-roleplay#airp

Preguntas frecuentes

¿Qué es Spherse?
Un runtime de escritorio local-first donde varios agentes de IA comparten una carpeta de proyecto, se ejecutan según horarios o eventos y dan vida a apps HTML interactivas. Spherse es un runtime local para ejecutar agentes de IA sobre un directorio de proyecto compartido. Los archivos sin formato del proyecto sirven como datos del usuario, y cada agente puede tener su propio prompt de sistema, permisos de herramientas, skills privadas y compartidas, conexiones a servidores MCP, varias sesiones persistentes y temas de chat. Las sesiones se guardan en una base de datos SQLite dentro del proyecto, y la configuración de los agentes usa Markdown, YAML y JSON.
¿Spherse es gratuito? ¿Qué licencia tiene?
Spherse es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Spherse sigue mantenido?
Mantenimiento activo. El último commit de Spherse fue el 22 oct 2026.
¿Para qué puedo usar Spherse?
Mantener un mundo ficticio persistente o una experiencia de role-play interactiva con varios personajes Crear un sistema personal de registro con dashboards y resúmenes diarios programados Coordinar agentes de investigación, síntesis y archivado en una carpeta de conocimiento compartida Crear herramientas HTML personalizadas que lean datos locales y envíen solicitudes a agentes
¿Cómo se instala Spherse?
Clona el repositorio: git clone https://github.com/mengrru/Spherse.git Entra en la carpeta del proyecto: cd Spherse Instala las dependencias: npm install Inicia la aplicación en modo de desarrollo: npm run dev
¿Dónde consigo Spherse?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/mengrru/Spherse

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados