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.