Sobre o projeto

Eloquent Notes é um utilitário de bandeja do sistema Linux para ditado offline rápido no Obsidian. Ele roda em segundo plano, grava clipes de voz curtos e os processa inteiramente na máquina local usando um modelo Gemma 4 servido pelo Ollama. Fluxo de trabalho: clique no ícone da bandeja (ou acione um atalho global / comando CLI) para iniciar a gravação, clique novamente para parar. O áudio é capturado na memória, convertido em bytes WAV e enviado por um pipeline de LLM em três fases: transcrição, reescrita em prosa de nota em primeira pessoa com um título, e classificação produzindo um tipo de nota, wikilinks e tags. O resultado é gravado no cofre Obsidian configurado, seja como um arquivo independente ou anexado a uma nota diária. Capacidades notáveis descritas no README: - UX de bandeja do sistema com ícones de estado desenhados dinamicamente (ocioso, gravando, processando) e um menu de contexto para configuração, recarregar e sair. - Comandos CLI: alternar gravação, abrir a GUI de configuração e instalar uma entrada de inicialização automática. O comando de alternância se comunica com o daemon em execução por meio de um socket Unix local. - Editor gráfico de configuração cobrindo configurações gerais, opções do cofre Obsidian, configurações de IA/Ollama, parâmetros de áudio, prompts e modelos de notas. - Integração com Obsidian: callouts por tipo de nota, injeção de wikilink com correspondência de limite de palavra sem distinção entre maiúsculas e minúsculas, geração de tags, análise e mesclagem de frontmatter YAML sem duplicação, e organização de pastas configurável (nenhuma, mês, semana, mês+semana). - Ditado multilíngue com um idioma de saída configurável para títulos, prosa, wikilinks e tags. - Prompts Markdown personalizáveis para cada fase do pipeline e tratamento de novas tentativas, além de três modelos de notas com espaços reservados para título, texto, tags, data e hora. - Design voltado à privacidade: nenhum arquivo de áudio temporário é gravado no disco; o áudio permanece na memória. - Lógica de nova tentativa e validação para saída JSON estruturada do modelo, com contagem de tentativas configurável. - Logs rotativos compatíveis com XDG. Requisitos e restrições: Ollama em execução localmente com um modelo Gemma 4 baixado (padrão gemma4:e4b-it-qat), PortAudio instalado e um serviço de notificação de desktop. O README afirma que os modelos de áudio Gemma 4 suportam clipes de até 30 segundos, e a ferramenta é otimizada para ditados dentro desse limite. A instalação é oferecida via pipx ou uv do GitHub, ou como uma instalação local editável para desenvolvimento.