LibreOffice e Ollama: LocalWriter, a IA no Writer

O LibreOffice não tem um assistente de IA integrado, mas uma extensão de terceiros pode conectar o Writer a um modelo servido pelo Ollama na sua máquina. Este guia parte do LocalWriter, um projeto open source publicado no GitHub: onde encontrá-lo, como apontá-lo explicitamente para o http://localhost:11434, quais permissões ele obtém e o que pode dar errado. A dupla LibreOffice + Ollama não garante, por si só, a privacidade: tudo depende do endereço do servidor que você digita na extensão.
#Por que conectar o LibreOffice ao Ollama
O Writer é a ferramenta de redação de muitos usuários domésticos, associações e órgãos públicos. As suítes de escritório comerciais agora oferecem assistentes de redação, mas eles enviam o texto para um serviço on-line. Com o Ollama instalado no mesmo computador, um modelo open-weight pode reformular, continuar ou corrigir um trecho sem que o documento saia da máquina, desde que toda a cadeia esteja configurada corretamente de ponta a ponta.
O princípio é simples. O Ollama roda em segundo plano e responde a requisições HTTP na porta 11434. Uma extensão do LibreOffice pega o texto selecionado, envia-o para esse endereço com uma instrução e depois insere a resposta no documento. A extensão não contém modelo: ela serve de intermediária entre o Writer e um servidor. É por isso que o endereço desse servidor define tudo, inclusive a privacidade.
Essa configuração serve para tarefas curtas e verificáveis: reformular um parágrafo, sugerir uma continuação para um rascunho, mudar o tom, resumir uma seção. Ela não substitui uma revisão. Um modelo local erra como um modelo online, e muitas vezes mais, se for pequeno.
#LocalWriter: o que a extensão faz
Aproveite a nossa experiência e um percurso guiado para criar o seu assistente local e usar a sua IA no dia a dia.
- Espaço online vitalício
- PDF + arquivos
- Reembolsado em 30 dias
O LocalWriter é uma extensão do LibreOffice desenvolvida por terceiros (conta do GitHub balisujohn), sem vínculo com a The Document Foundation nem com a equipe do Ollama. Na consulta de 30 de outubro de 2026, o README descrevia dois usos principais no Writer: continuar o texto selecionado e modificar a seleção de acordo com uma instrução que você digita. A extensão se comunica com um servidor compatível com a API da OpenAI; o Ollama oferece uma, assim como outros servidores locais.
- Natureza
- Arquivo de extensão do LibreOffice (.oxt), distribuído na página Releases do repositório no GitHub.
- Funções descritas
- Estender uma seleção; editar uma seleção a partir de uma instrução. Confira no README os nomes exatos dos menus, eventuais atalhos e as funções adicionadas desde então (por exemplo, para o Calc).
- Servidor de destino
- Qualquer servidor que exponha uma API no estilo da OpenAI: Ollama, mas também outros mecanismos locais ou um serviço on-line. Nada exige um servidor local: é você quem digita o endereço.
- Status
- Projeto comunitário. Ninguém garante o ritmo de atualização, a manutenção nem a compatibilidade com as novas versões do LibreOffice. Confira a data do último commit e as issues abertas.
Outras extensões ou macros têm o mesmo objetivo. Os princípios deste guia (endereço explícito, controle de permissões, verificação de compatibilidade) valem para todas elas: não encare o LocalWriter como uma recomendação, mas como um exemplo documentado.
#Pré-requisitos
- LibreOffice
- Uma versão recente instalada a partir de libreoffice.org ou da sua distribuição. Anote o número exato (Ajuda > Sobre o LibreOffice): você vai precisar dele para verificar a compatibilidade anunciada pela extensão.
- Python no LibreOffice
- Extensões escritas em Python precisam do suporte a Python do LibreOffice. Ele vem incluído nos instaladores oficiais para Windows e macOS; em algumas distribuições Linux, é um pacote separado (veja a etapa 2).
- Ollama
- Instalado e em execução, escutando em http://localhost:11434. Se ainda não estiver, siga primeiro o guia de instalação do Ollama (link no fim da página).
- Um modelo adequado à sua memória
- Referências em Q4_K_M: um 3B ocupa cerca de 2 GB de VRAM, um 7B cerca de 5 GB, um 14B cerca de 9 GB. Uma placa de 12 GB como a RTX 3060 comporta com folga um modelo de 7B a 9B.
- Um documento de teste
- Um arquivo sem dados sensíveis para os primeiros testes e um backup dos seus documentos importantes antes de instalar uma extensão.
#Etapa 1: preparar o Ollama e verificar a API
Antes de mexer no LibreOffice, confirme que o Ollama responde pela API compatível com a OpenAI. Se esta etapa falhar, a extensão também vai falhar, e você saberá que o problema não está nela. Primeiro, baixe um modelo de tamanho razoável. As duas tags abaixo constavam na biblioteca do Ollama em 28 de outubro de 2026; se preferir, substitua-as por um modelo que você já tenha instalado.
Em seguida, consulte a API do mesmo jeito que a extensão fará. O primeiro comando lista os modelos visíveis para a API; o segundo envia uma requisição de conversa real. Uma resposta JSON com um campo choices significa que o servidor está pronto.
Verifique também em qual endereço o Ollama está escutando. Por padrão, ele só aceita conexões da própria máquina (127.0.0.1), que é a configuração certa para uso no Writer no mesmo computador. Se alguém tiver definido OLLAMA_HOST=0.0.0.0, o servidor fica acessível pela rede local: isso não é necessário aqui.
#Etapa 2: instalar a extensão no LibreOffice
- 01Ler o repositório antes de baixarAbra https://github.com/balisujohn/localwriter. Leia o README inteiro e depois a página Releases: número da versão mais recente, data, notas da versão, versões do LibreOffice mencionadas. Veja também as issues abertas: uma incompatibilidade conhecida com a sua versão costuma aparecer ali antes de ser documentada.
- 02Baixar o arquivo .oxt na página ReleasesUse o arquivo .oxt anexado a uma versão publicada, não uma cópia encontrada em outro site. Se o projeto publicar um hash SHA-256, compare-o com o arquivo baixado; caso contrário, anote simplesmente o número da versão e a data do download.
- 03Inspecionar o conteúdo (opcional, mas útil)Um .oxt é um arquivo zip. Listar o conteúdo permite ver os scripts Python que o LibreOffice vai executar e, portanto, o que a extensão pode fazer (veja a seção Permissões).
- 04Instalar com o Gerenciador de extensõesNo LibreOffice: Ferramentas > Gerenciador de extensões > Adicionar e escolha o arquivo .oxt. O LibreOffice pode exibir um aviso sobre a origem da extensão ou perguntar se você quer instalá-la só para você ou para todos os usuários: escolha "somente para mim" em um computador compartilhado.
- 05Reiniciar o LibreOffice por completoFeche todas as janelas do LibreOffice, inclusive o Início rápido na área de notificação, se houver, e abra o Writer novamente. Um novo menu ou novas entradas devem aparecer; a localização exata está indicada no README.
No Windows, o unopkg fica na pasta program do LibreOffice (por exemplo C:\Program Files\LibreOffice\program). No Fedora, o suporte a Python é fornecido pelo pacote libreoffice-pyuno. As versões Flatpak e Snap do LibreOffice incluem seu próprio ambiente: em caso de problema, compare com a versão dos pacotes da distribuição ou com a de libreoffice.org.
#Etapa 3: configurar explicitamente para o Ollama local
A extensão abre uma janela de configurações (a localização dela está descrita no README). Esta é a etapa mais importante do guia: cada campo determina para onde vai o seu texto e como o modelo o processa. Não deixe nenhum valor padrão que você não tenha lido.
- Endereço do servidor
- Digite http://localhost:11434 ou http://127.0.0.1:11434. Dependendo de como a extensão monta as requisições, ela espera essa raiz ou o endereço com o prefixo /v1: siga o exemplo do README e, em caso de erro 404, tente a outra forma.
- Nome do modelo
- Exatamente o nome exibido por ollama list, incluindo a tag (qwen3.5:9b e não qwen3.5). Um nome incorreto gera um erro "model not found" no Ollama.
- Chave de API
- O Ollama local não exige uma. Se o campo for obrigatório, qualquer valor costuma bastar; nunca cole ali uma chave real de um serviço on-line para uso local.
- Instruções de sistema
- Se a extensão permitir alterar as instruções, escreva-as em francês e de forma curta: "Altere apenas o trecho fornecido. Responda em francês, sem comentários nem aspas." Isso reduz respostas prolixas inseridas no documento.
- Comprimento máximo
- Um limite de tokens baixo demais corta a resposta no meio de uma frase; alto demais, deixa o modelo se estender além da conta. Comece com um valor modesto e ajuste.
No primeiro teste, abra o documento de teste, selecione uma frase e execute a função de edição com uma instrução simples, por exemplo "Deixe este parágrafo mais formal". Durante a geração, o comando ollama ps em um terminal mostra o modelo carregado: é uma prova direta de que a requisição chegou ao seu Ollama local, e não a outro lugar. A primeira chamada pode ser lenta, pelo tempo de carregar o modelo na memória.
#Permissões e privacidade: o que a extensão pode fazer
Uma extensão do LibreOffice não é isolada como uma extensão de navegador. Os scripts Python dela são executados com as permissões da sua conta de usuário: eles podem ler e gravar seus arquivos, abrir conexões de rede e ler o conteúdo do documento aberto. Nenhuma janela de permissões detalha esses direitos na instalação. Instalar um .oxt significa, portanto, confiar no autor e na versão baixada.
- O código é legível
- O LocalWriter é open source: os scripts listados na etapa 2 podem ser revisados. Procure endereços de rede fixos no código e funções de envio HTTP; uma extensão honesta só chama o endereço que você informou.
- As atualizações também contam
- Uma nova versão pode mudar o comportamento. Leia as notas de versão antes de atualizar e evite versões de desenvolvimento não lançadas para uso real.
- O endereço define a privacidade
- Com http://localhost:11434, o texto selecionado fica na máquina. Com o endereço de outro PC, ele trafega pela sua rede. Com o endereço de um serviço online compatível com a OpenAI, ele vai para esse provedor, sob as condições dele.
- Os modelos hospedados pela Ollama
- As versões recentes do Ollama também oferecem modelos executados nos servidores do ollama.com, acessíveis com uma conta. Um modelo desses escolhido no campo "modelo" envia o texto para a internet mesmo que o endereço continue sendo localhost. Verifique na página do modelo se ele é um modelo local e se ollama ps o mostra carregado na sua máquina.
#Limites de compatibilidade que você precisa conhecer
Várias camadas precisam estar em sintonia: a versão do LibreOffice, o interpretador Python dele, a extensão e a versão do Ollama. Nenhuma delas é controlada pelos outros projetos, e este guia não testou nenhuma combinação. Estes são os pontos de atrito mais prováveis, a serem conferidos com o README e os tickets do repositório.
- Versão do LibreOffice
- Uma extensão testada em uma versão pode quebrar na seguinte se a API interna mudar. Compare a sua versão com as citadas no repositório; na falta de indicação, considere a compatibilidade como desconhecida.
- Python incluído ou ausente
- O LibreOffice traz o próprio Python no Windows e no macOS e costuma usar o do sistema no Linux. Uma extensão que importa uma biblioteca ausente vai falhar ao carregar.
- Formato da API
- A extensão fala o dialeto da OpenAI. O Ollama o implementa em /v1, mas não necessariamente todas as opções. Uma opção não suportada pode ser ignorada sem nenhuma mensagem.
- Documentos complexos
- Seleções que abrangem tabelas, notas de rodapé, campos ou controle de alterações podem perder a formatação: o modelo recebe texto simples e devolve texto simples.
- Comprimento
- A seleção e a instrução precisam caber na janela de contexto configurada no Ollama. Além disso, o início do texto pode ser truncado sem aviso. Trabalhe parágrafo por parágrafo.
- Calc, Impress
- Não presuma que uma função criada para o Writer funcione em outros lugares: somente os aplicativos citados no README são suportados.
- Interface travada
- Dependendo da implementação, o Writer pode parar de responder enquanto o modelo está gerando. Com um modelo grande demais para a VRAM, a espera fica bem mais longa: prefira um modelo que caiba inteiramente na memória de vídeo.
#Solução de problemas do LibreOffice com o Ollama
- 01Nenhum menu aparece após a instalaçãoReinicie o LibreOffice por completo, incluindo o Início rápido. Verifique em Ferramentas > Gerenciador de extensões se a extensão está listada e ativada. No Linux, instale o suporte a Python (libreoffice-script-provider-python ou libreoffice-pyuno) e tente novamente.
- 02"Connection refused" ou tempo esgotadoO Ollama não está em execução ou está escutando em outro endereço. Execute de novo os comandos curl da etapa 1: se falharem, o problema está no Ollama. Se funcionarem, compare caractere por caractere o endereço digitado na extensão (http e não https, porta 11434).
- 03Erro 404O caminho não confere: talvez a extensão já acrescente /v1 ou, ao contrário, espere encontrá-lo no endereço. Tente a outra forma indicada na etapa 3.
- 04« model not found »Copie o nome exato informado pelo ollama list, com a tag. Se o modelo não estiver instalado, execute ollama pull.
- 05Resposta em inglês, cercada de comentários ou aspasReforce a instrução de sistema (resposta em francês, somente texto) ou troque de modelo. Modelos pequenos seguem pior esse tipo de instrução.
- 06Writer muito lento ou travadoExecute ollama ps: se a coluna PROCESSOR indicar uma parcela de CPU, o modelo não cabe inteiro na VRAM. Mude para um modelo menor ou para uma quantização mais leve e feche os outros modelos carregados.
#Para se aprofundar
Este guia se concentra na ponte entre o Writer e o Ollama. A instalação do servidor, o compartilhamento dele na rede e o enquadramento jurídico têm um guia próprio.
- Instalar Ollama
- Instalação passo a passo no Windows, macOS e Linux, pré-requisito da etapa 1: https://quelllm.fr/guide/installer-ollama
- Compartilhar o Ollama na rede local
- Se o Writer roda em uma máquina diferente do servidor: configuração de OLLAMA_HOST e precauções de acesso: https://quelllm.fr/guide/ollama-serveur-reseau-local-partage
- LLM local e RGPD
- O que o processamento local muda, e o que não muda, para dados pessoais em empresas: https://quelllm.fr/guide/llm-local-donnees-privees-rgpd
- Fontes
- Repositório do LocalWriter: https://github.com/balisujohn/localwriter (consultado em 30/10/2026, não revisado em 17/11/2026); documentação da API compatível com a OpenAI do Ollama: https://docs.ollama.com (não revisada em 17/11/2026). Confira-os antes de instalar: as versões e as funções mudam.
Um comentário, um erro ou uma observação? Avise-nos; isso ajuda a melhorar o guia para todos.