Verso English

Notas em Markdown · local-first · servidor próprio

Suas notas são arquivos. O servidor é seu.

O Verso é um app de notas que abre qualquer pasta de arquivos Markdown — um vault do Obsidian também — e nunca reescreve um arquivo ao abri-lo. Com o UniVerso, o servidor do Verso que você mesmo instala, a mesma pasta fica em dia entre seus computadores, abre no navegador e no celular, e pode ser partilhada com outras pessoas.

estado
em teste; ainda sem download público
roda em
macOS, Windows e Linux; no navegador e no celular, por um UniVerso
servidor
UniVerso, numa máquina sua: um mini PC, um NAS, a menor VPS
licença
MPL-2.0
custa
nada além da máquina onde ele roda

Entrar na lista de espera Ler o que ainda não faz

A janela do Verso aberta num navegador. À esquerda, a árvore de arquivos de uma pasta chamada Exemplo, com subpastas Diário, Personagens, Projetos e Templates. À direita, a nota “Bem-vindo ao Verso”, com propriedades (título, data, tags, status, autor) e dois callouts.
Fig. 1 A janela do Verso no navegador, servida por um UniVerso: a pasta de exemplo que acompanha o app, com propriedades e callouts como no Obsidian.

Para quem é

  • Para quem já guarda notas em Markdown — no Obsidian ou numa pasta qualquer — e quer as mesmas notas no computador, no navegador e no celular sem um serviço de terceiros no meio.
  • Para uma casa, um grupo de RPG ou um time pequeno que quer partilhar pastas num servidor que alguém de confiança roda.
  • Para quem quer que um agente de IA leia as notas: o Verso traz um servidor MCP que busca e lê a pasta, sem depender de um provedor de modelo.

Como funciona

Os arquivos são a verdade

Cada nota é um arquivo .md numa pasta comum do seu disco. O Verso abre a pasta como um editor de código abre: sem importar nada e sem um banco de dados no lugar dos arquivos. O índice de busca é um cache; apagá-lo não perde nada.

Abrir um arquivo nunca o reescreve — nem o frontmatter, nem as quebras de linha, nem os espaços. Converter algo é uma ação sua, com a diferença à vista. Toda gravação é atômica e confere antes se o arquivo mudou no disco desde que foi lido; se mudou, o Verso mostra a diferença em vez de gravar por cima.

O servidor é seu

O UniVerso é o Verso como servidor: um só programa, instalado por imagem Docker (amd64 e arm64), por pacote .deb ou .rpm com systemd, ou por um arquivo compactado. Nele ficam as contas e as pastas — pastas comuns de Markdown no disco do servidor. Ninguém se cadastra sozinho: quem administra convida. Cada pasta tem um dono, quem edita e quem só lê.

Sincronizar
Uma pasta deste computador fica em dia com uma pasta do UniVerso. A mudança cruza ao salvar. Um arquivo mudado dos dois lados vira uma cópia ao lado, nunca uma perda; a primeira sincronização não apaga nada.
Partilhar
O dono dá a outra conta do mesmo UniVerso acesso de leitura ou de escrita a uma pasta, e pode tirar depois.
Editar junto
Com a sincronização conectada, uma nota aberta por duas pessoas recebe as edições da outra letra a letra, com o cursor e o nome de cada uma.
Lixeira
O que é apagado fica 30 dias por padrão, com quem apagou e quando, e volta para o lugar com “Restaurar”.
Console
Quem administra vê contas, pastas, convites, cotas e o registro de auditoria em /admin.
Navegador e celular
O UniVerso serve a mesma janela do app; no celular e no tablet ela se instala na tela inicial.
O painel Sincronizar dos ajustes do Verso, com o título “Tudo em dia.”, a linha “demo-vault em notas.casa · você é dona da pasta · última vez há 2 min”, os botões Sincronizar agora, Pausar e Desligar, e a seção Esperando por você, vazia.
Fig. 2 Ajustes › Sincronizar quando não há nada esperando por você.
Os ajustes do Verso num celular, na seção Servidores: um UniVerso chamado notas.casa, a conta conectada e três pastas com o papel da pessoa em cada uma — Caderno (dona), Mesa de RPG (edita), Regras da Bia (só lê) — cada uma com o botão Abrir aqui.
Fig. 3 No celular: as pastas de um UniVerso, com o papel de cada pessoa — dona, edita, só lê.

Uma VPS de 1 GB dá conta

Medimos numa máquina virtual do tamanho da menor VPS: 1 núcleo, 1 GB de memória, disco virtual de 10 GB, Ubuntu sem interface gráfica e o UniVerso instalado do .deb. Quatro computadores — dois Macs, um Windows e um Linux — sincronizaram com ela uma pasta de 133 arquivos e 62 MB.

O que a máquina de 1 núcleo e 1 GB mostrou
SituaçãoMedido
Programa recém-iniciado cerca de 18 MB de memória
20 minutos com os quatro editando CPU abaixo de 2 %; as cinco cópias iguais byte a byte em toda conferência
Primeira sincronização dos 62 MB para os quatro ao mesmo tempo 69 s
Um aparelho gravando sozinho cerca de 100 ms por gravação — o tempo do disco
50 aparelhos gravando ao mesmo tempo por 60 s 1001 operações; metade esperou até 4,5 s na fila do disco; nenhum problema de integridade
Depois de uma rajada de 50, no build distribuído cerca de 70 MB retidos
Numa máquina com 453 MiB de memória duas rajadas de 50 sem o processo ser derrubado, com metade da vazão

O mínimo que indicamos: 1 núcleo e 512 MB, para 1 a 3 pessoas com anexos pequenos. Para uma família ou um time de até umas 10 pessoas, 2 núcleos e 2 GB — uma estimativa, ainda não medida. A máquina estava na rede local, não num provedor; Raspberry Pi e NAS ainda não foram medidos.

As vazões vêm do build usado nos testes; a memória depois da rajada, do build que é distribuído. Os números completos estão no guia de instalação do servidor, que sai junto com o código.

Funcionando

Gravado no laboratório de testes do Verso — por isso as pastas cheias de notas numeradas e de cópias de conflito.

A nota “Compras” aberta no navegador, no tema escuro, com uma lista. Uma nova linha, escrita em outro computador, aparece no fim: “escrito no Mac B às 22:02:52, visto no navegador em segundos”.
Fig. 4 Uma linha escrita num Mac aparece no navegador em segundos.
O painel Sincronizar com o título “128 coisas esperam por você”. Cada item é uma nota que mudou em dois lugares, com os botões Comparar, Abrir as duas, Ficar com esta e Descartar cópia; ao comparar, aparecem as linhas que só estão de um lado, marcadas com menos e mais.
Fig. 5 O que mudou dos dois lados vira uma cópia, e o Verso mostra a diferença para você escolher.
O editor do Verso com uma nota que mudou no disco enquanto alguém digitava. Um aviso diz que nada foi gravado e mostra a diferença entre o disco e o texto digitado, com três escolhas: Descartar o meu e recarregar, Gravar o meu por cima, Guardar os dois.
Fig. 6 A nota mudou no disco enquanto você digitava: nada é gravado por cima. Você escolhe — descartar o seu, gravar o seu por cima ou guardar os dois.
O console de administração do UniVerso, no tema escuro, passando pelas páginas Visão geral, Contas, Pastas e Registro; o registro lista quem deu acesso a quem, em que pasta e quando.
Fig. 7 O console de quem administra: visão geral, contas, pastas e o registro de auditoria.

O que ainda não faz

Melhor saber antes.

  • Não tem download público. O repositório do Verso ainda é privado. Quando abrir, os instaladores para macOS, Windows e Linux e os pacotes do UniVerso aparecem nesta página.
  • Não funciona offline no celular. No celular e no navegador você trabalha direto na pasta do servidor; sem conexão, não edita. Uma cópia local com fila de gravações é um passo posterior.
  • Não tem plugins. Nem os do Obsidian, nem plugins próprios. Um sistema de plugins está planejado; os plugins do Obsidian não rodam no Verso.
  • Não tem link público para partilhar. A partilha é entre contas do mesmo UniVerso. Um link que qualquer pessoa abre, sem conta, não existe.
  • Não tem criptografia de ponta a ponta. Editar junto e buscar no servidor exigem que o servidor leia os arquivos: quem hospeda vê as notas. A criptografia em repouso é a do disco do servidor.
  • Não sincroniza por Dropbox, Google Drive ou iCloud. Hoje a sincronização é só com um UniVerso.

Perguntas

Qual é a licença?

MPL-2.0, para o núcleo e para o app. Você pode usar, estudar, mudar e redistribuir. Quem distribui uma versão mudada de um arquivo do Verso publica aquele arquivo; rodar o Verso como serviço não obriga a publicar nada.

É compatível com o Obsidian?

O Verso estende o dialeto do Obsidian e nunca o contradiz: links [[…]], embeds, callouts, tags, propriedades no frontmatter e boards .canvas (JSON Canvas) abrem como no Obsidian, e nenhuma extensão do Verso muda o sentido de algo que já existe. A configuração do Verso fica fora da pasta, então o mesmo vault abre nos dois.

O Verso não é um clone do Obsidian e não roda os plugins dele.

E a privacidade?

O app não manda telemetria. Ele só vai à rede para endereços que estão nas suas notas ou em que você clica, para ver se há versão nova e para o UniVerso que você configurou.

No UniVerso, as notas ficam no disco de quem hospeda — e quem hospeda pode lê-las (veja acima).

Este site não tem analytics nem cookies. A lista de espera guarda seu e-mail, o idioma da página e a hora, e serve só para avisar quando houver o que baixar.

Quanto custa?

Nada. Não há serviço pago nem plano pago; o único dinheiro previsto são doações, e doação não compra recurso. O servidor é a sua máquina: um computador em casa, um NAS ou uma VPS cuja conta você já paga.

Quando abre?

Sem data marcada. Deixe o e-mail e avisamos quando houver o que baixar.

Lista de espera

Um e-mail quando houver o que baixar.

Guardamos o e-mail, o idioma desta página e a hora; nenhum outro dado pessoal (o endereço de rede só conta as tentativas, embaralhado, e some em uma hora). Para sair da lista, escreva para sergiosjs@pm.me.