6

Pitch: Criei o Brain Core: um workspace de notas

Fala, pessoal! Beleza?

Queria compartilhar um projeto open-source que venho desenvolvendo: o Brain Core.

O Brain Core é um workspace self-hosted para organizar notas, páginas, ideias visuais, arquivos e gravações em um ambiente que roda em uma máquina controlada pelo próprio usuário.

A ideia começou de forma bem simples: eu queria uma ferramenta que se encaixasse no meu fluxo de trabalho no navegador, reunindo texto e canvas visual no mesmo lugar, sem depender obrigatoriamente de serviços externos.

Sei que já existem ferramentas excelentes nesse espaço, como o Obsidian. O objetivo aqui nunca foi tentar substituir tudo o que já existe, mas construir algo do zero, aprender no processo e adaptar a ferramenta ao tipo de uso que eu procurava.

O que dá para fazer hoje

Atualmente o Brain Core possui:

  • páginas de texto com editor baseado em Tiptap;
  • páginas e subpáginas organizadas em árvore;
  • tags, status e datas;
  • notas rápidas e lembretes;
  • canvas visual infinito usando tldraw;
  • histórico de versões das páginas;
  • lixeira e recuperação de conteúdo;
  • upload de imagens e documentos;
  • leitura de PDFs diretamente dentro das páginas;
  • compartilhamento de páginas e pastas entre usuários da mesma instalação;
  • permissões de visualização e edição;
  • atualização das páginas em tempo real entre abas;
  • autenticação com suporte opcional a 2FA.

Tudo isso fica armazenado na própria instalação.

Gravações e Timeline

Uma das partes que mais evoluiu recentemente foi a área de gravações.

É possível iniciar uma gravação diretamente pelo navegador e visualizar o conteúdo posteriormente pela Timeline.

Também criei um aplicativo para Android.

No celular, as gravações são divididas em pequenos trechos e armazenadas localmente. Se o aparelho estiver sem conexão, a fila permanece salva e os arquivos são enviados quando o servidor volta a ficar acessível.

A fila também sobrevive ao fechamento ou reinício do aplicativo, evitando perder os trechos que ainda não foram enviados.

O aplicativo possui ainda uma área para acessar a interface web da própria instalação do Brain Core.

Transcrição local opcional

Também existe um serviço opcional de transcrição.

Quando habilitado, ele pode:

  • transcrever as gravações localmente;
  • organizar sessões por data;
  • pesquisar dentro das transcrições;
  • separar as falas por participantes;
  • permitir revisão das identificações;
  • transformar trechos das transcrições em notas ou lembretes.

A instalação padrão não ativa essa parte automaticamente.

Quem quiser utilizar a transcrição pode processar o conteúdo por CPU ou configurar um worker separado para aceleração com uma GPU NVIDIA compatível.

Ou seja: não é necessário ter GPU, modelo de IA ou serviço de nuvem para instalar e utilizar as funcionalidades principais do Brain Core.

A parte de transcrição é um recurso adicional para quem quiser habilitá-la.

Android e acesso privado

O aplicativo para Android também está disponível no projeto.

O APK assinado pode ser obtido pelos releases do GitHub:

Baixar a versão mais recente do Brain Core para Android

Para utilizar o celular sem precisar publicar o Brain Core diretamente na internet, preparei também um guia utilizando Tailscale Serve.

A ideia é manter o servidor privado e permitir que computador e celular se comuniquem pela rede privada do Tailscale.

Assim é possível acessar a própria instalação do Brain Core pelo celular sem simplesmente expor o serviço para a internet.

Stack

O projeto atualmente utiliza:

Frontend

  • React 19
  • TypeScript
  • Vite
  • Tailwind CSS
  • Tiptap
  • tldraw

Backend

  • Node.js
  • Express
  • PostgreSQL
  • Socket.IO

Infra

  • Docker
  • Docker Compose

Instalação

A instalação padrão foi pensada para ser relativamente simples.

Com Docker Engine e Docker Compose instalados:

git clone https://github.com/lizard-wizard42/Brain_Core.git
cd Brain_Core
docker compose up --build -d
docker compose ps

Depois, basta acessar:

http://localhost:8080

No primeiro acesso, o Brain Core abre um assistente para criação da conta administrativa.

A instalação padrão não exige conta em nuvem, chave de API ou GPU.

Também não é necessário habilitar a parte de gravação e transcrição para utilizar o Brain Core como workspace de notas e organização.

Os recursos opcionais possuem documentação separada no próprio repositório.

Dados e funcionamento local

Uma das ideias do projeto é que a instalação continue sob controle de quem está utilizando.

Na configuração padrão, o banco de dados, uploads e demais dados persistentes ficam armazenados nos volumes locais da instalação.

Também procurei manter recursos mais sensíveis ou específicos, como transcrição e algumas integrações, separados da instalação principal e desativados por padrão.

Quem quiser apenas subir o Brain Core para testar as páginas, notas e canvas não precisa configurar toda a infraestrutura opcional.

Projeto open-source

Resolvi abrir o código porque, além de ser uma ferramenta que uso e continuo desenvolvendo, acredito que algumas partes da estrutura possam ser úteis para outras pessoas interessadas em software self-hosted, organização pessoal e ferramentas de conhecimento.

O projeto continua evoluindo e ainda existem várias coisas que pretendo melhorar.

Se alguém quiser testar, encontrar algum bug, sugerir melhorias ou simplesmente explorar o código, fica à vontade.

🔗 Repositório:
https://github.com/lizard-wizard42/Brain_Core

A documentação do projeto também está no repositório, incluindo os guias de Docker, Android, Tailscale, Timeline e transcrição local.

Obrigado a quem já testou, deu star, fez fork ou deixou algum comentário por aqui.

Foi muito legal ver gente realmente clonando, instalando e rodando o projeto. Feedback sobre instalação, bugs e uso no dia a dia continua muito bem-vindo.

Carregando publicação patrocinada...
1

Parabens pela iniciativa, eh sempre interessante acompanhar projetos reais usando tecnologia para automatizar as tarefas do dia-a-dia

Repositorio devidamente starreado e forkeado, obrigado por compartilhar !

Saude e Sucesso !


Este post foi favoritado via extensão TABNEWS FAVORITOS

Tem curiosidade sobre IA ? Da uma olhada no meu LIVRO: IA PARA ENGENHEIROS

1
1
0