Repolode
Enviar
mengrru

mengrru/Spherse

Um runtime desktop local-first em que vários agentes de IA compartilham uma pasta de projeto, são executados por agendamento ou eventos e dão vida a apps HTML interativos.

Ver no GitHubSite
Estrelas
91
Forks
12
Issues abertas
21
Último commit
há 12 horas

O que é?

Spherse é um runtime local para executar agentes de IA usando um diretório de projeto compartilhado. Os arquivos comuns do projeto servem como dados do usuário, e cada agente pode ter seu próprio system prompt, permissões de ferramentas, skills privadas e compartilhadas, conexões com servidores MCP, várias sessões persistentes e temas de chat. As sessões são armazenadas em um banco de dados SQLite dentro do projeto, e a configuração dos agentes usa Markdown, YAML e JSON.

A automação é feita por triggers que executam agentes em uma programação cron ou em resposta a eventos personalizados com payloads. Os eventos podem vir do usuário, de uma página HTML ou de outro agente. O servidor de preview integrado serve arquivos HTML, imagens e outros arquivos do projeto, e um SDK de UI permite que essas páginas leiam e gravem dados JSON, criem sessões, enviem mensagens aos agentes e disparem eventos.

O app desktop é desenvolvido com Electron e React para macOS, Windows e Linux, e um cliente web protegido por token permite que dispositivos móveis se conectem ao runtime desktop. A pasta inteira do projeto pode ser copiada ou compartilhada como uma unidade, incluindo dados, configurações dos agentes, skills, triggers e páginas.

Recursos principais

  • 01Vários agentes com prompts, permissões de ferramentas, skills e conexões MCP próprios em um mesmo projeto
  • 02Triggers de cron e eventos personalizados que executam agentes em sessões novas ou existentes
  • 03Servidor de preview HTML integrado com um SDK de UI para ler dados e interagir com agentes
  • 04Armazenamento local: arquivos comuns, configurações em Markdown/YAML/JSON e sessões SQLite
  • 05Apps desktop para macOS, Windows e Linux, além de um cliente web móvel protegido por token

Casos de uso

  • Manter um mundo fictício persistente ou uma interpretação de papéis interativa com vários personagens
  • Criar um sistema pessoal de registros com dashboards e resumos diários agendados
  • Coordenar agentes de pesquisa, resumo e arquivamento em uma pasta de conhecimento compartilhada
  • Criar ferramentas HTML personalizadas que leem dados locais e enviam solicitações aos agentes

Início rápido

  1. 1

    Clone o repositório

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

    Acesse a pasta do projeto

    cd Spherse
  3. 3

    Instale as dependências

    npm install
  4. 4

    Inicie o app em modo de desenvolvimento

    npm run dev

Antes de usar

  • O desenvolvimento local requer Node.js 22.19 ou mais recente.
  • Você precisa de uma chave de API de um provedor de LLM compatível para criar agentes.
  • A versão para macOS não é assinada com um certificado Apple Developer, então o macOS pode exibir um aviso na primeira inicialização.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de privacidade e local-first

Tópicos

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

Perguntas frequentes

O que é Spherse?
Um runtime desktop local-first em que vários agentes de IA compartilham uma pasta de projeto, são executados por agendamento ou eventos e dão vida a apps HTML interativos. Spherse é um runtime local para executar agentes de IA usando um diretório de projeto compartilhado. Os arquivos comuns do projeto servem como dados do usuário, e cada agente pode ter seu próprio system prompt, permissões de ferramentas, skills privadas e compartilhadas, conexões com servidores MCP, várias sessões persistentes e temas de chat. As sessões são armazenadas em um banco de dados SQLite dentro do projeto, e a configuração dos agentes usa Markdown, YAML e JSON.
Spherse é gratuito? Qual é a licença?
Spherse é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Spherse ainda é mantido?
Manutenção ativa. O último commit de Spherse foi em 22 de out. de 2026.
Para que posso usar Spherse?
Manter um mundo fictício persistente ou uma interpretação de papéis interativa com vários personagens Criar um sistema pessoal de registros com dashboards e resumos diários agendados Coordenar agentes de pesquisa, resumo e arquivamento em uma pasta de conhecimento compartilhada Criar ferramentas HTML personalizadas que leem dados locais e enviam solicitações aos agentes
Como instalar Spherse?
Clone o repositório: git clone https://github.com/mengrru/Spherse.git Acesse a pasta do projeto: cd Spherse Instale as dependências: npm install Inicie o app em modo de desenvolvimento: npm run dev
Onde consigo Spherse?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mengrru/Spherse

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados