Começar

Primeiros passos

Instale o app, baixe um modelo e converse. Os instaladores publicados aqui são da versão 0.28.1.

1. Baixar e instalar

Baixe o instalador em Versões no GitHub, na seção Assets. “Source code” é só o código, não o app. Os mesmos arquivos estão em Downloads.

• O pacote Mac não roda em Mac Intel.
• No Windows, se os motores pedirem, instale o Microsoft Visual C++ Redistributable x64.
• No Linux, abra o app com seu usuário normal, sem sudo.
• Por ser alfa, o sistema pode avisar ao abrir. A assinatura de distribuição ainda não existe. No Mac, a assinatura é ad hoc, sem notarização. Confira a origem e o SHA-256. Não desative o Gatekeeper.

2. Primeira abertura

1. Abra o LocalNeuron. No login do aplicativo desktop, marque Lembrar meu acesso neste computador. A credencial é cifrada pelo armazenamento seguro do sistema; não é guardada no navegador. Quem usa sua sessão do computador poderá abrir o espaço. A opção é voluntária e pode ser desligada em Preferências → Acesso neste computador. O botão Bloquear aplicativo continua bloqueando a sessão atual.
2. Siga o assistente: confira a RAM e o disco, escolha o perfil e revise as recomendações.
3. Para refazer depois: Minha equipe → Mais opções da equipe → Repetir configuração. Perfil, conversas e membros são preservados.

3. Escolher e baixar um modelo

1. Abra Modelos.
2. Escolha um modelo de texto pequeno em Q4 marcado como compatível com o motor integrado. O filtro Para este PC ajuda a achar o porte certo.
3. Na ficha, confira RAM estimada, tamanho, licença e motor.
4. Baixe. O download pode ser retomado. O app confere o tamanho e o SHA-256.

Exemplo para começar: Qwen3 · Mini (0,64 GB, cerca de 2 GiB de RAM) ou Qwen3 · Equilibrado (2,50 GB, cerca de 5 GiB de RAM). As estimativas não substituem um teste.

Já tem GGUFs no LM Studio? O app encontra e reutiliza esses arquivos sem copiar.

4. Primeira conversa

1. Quando o download terminar, abra o Chat e selecione o modelo.
2. Escreva a mensagem. Na primeira vez, carregar o modelo na memória pode demorar.
3. Ative Ferramentas → Usar offline para desligar a internet e o terminal das ferramentas. O app avisa que o chat, o computador e os arquivos continuam locais. Esse botão não desliga os canais de Minha equipe: Anthropic e Grok (xAI) enviam o texto para o serviço, e outro computador envia o texto para fora quando o endereço não é deste computador. O EXO dessa equipe usa só o endereço deste computador (127.0.0.1).
4. Use Parar para interromper uma resposta. Liberar memória tira o modelo da RAM sem apagá-lo do disco.

5. Onde ficam seus dados

• macOS: ~/Library/Application Support/Colmeia/
• Windows: %APPDATA%/Colmeia/
• Linux: ~/.config/Colmeia/ ou $XDG_CONFIG_HOME/Colmeia/

Colmeia é o nome antigo, mantido por compatibilidade. Instalações antigas no Mac podem usar Colmeia-data/, ao lado do app. A pasta de trabalho das ferramentas fica fora dessa pasta. Inclua-a no backup.

6. Backup e restauração

Fazer backup

1. Pause tarefas em andamento e feche o app.
2. Copie a pasta inteira de dados, a que contém workspace/. Ela também guarda browser/, session/ e logs/.
3. Guarde a cópia em outro lugar. O backup só do cofre não inclui conversas, projetos nem modelos.

Restaurar

1. Abra o LocalNeuron e vá em Preferências.
2. Clique em Abrir uma pasta de dados existente.
3. Selecione a pasta que contém workspace/. O app procura workspace/vault.enc.json.
4. O app reabre esse espaço. A pasta atual fica intacta.

Para apontar outra pasta antes de abrir, defina LOCALNEURON_DESKTOP_DATA_DIR. Esse nome tem prioridade sobre o botão. O nome antigo COLMEIA_DESKTOP_DATA_DIR ainda é aceito, mas está descontinuado: o app avisa para trocá-lo.

7. Atualizar

Feche o app, instale a versão nova e substitua só o aplicativo. Não apague a pasta de dados. Desde a 0.27, o app avisa em Preferências → Atualizações.