Guia de Instalacao no Linux

Este guia orientara voce na instalacao do Sokuji em sistemas Linux. O Sokuji esta disponivel como pacote .deb para distribuicoes baseadas em Debian/Ubuntu e como AppImage para compatibilidade universal.

Baixar para Linux

Requisitos do Sistema

Ubuntu 20.04 ou posterior, Debian 10 ou posterior, ou distribuicao equivalente
Processador de 64 bits
4GB de RAM minimo (8GB recomendado)
100MB de espaco em disco disponivel
PulseAudio ou PipeWire para suporte de audio
Conexao com a internet para servicos de IA

Etapas de instalacao

Passo 1: Baixar o Sokuji

Visite a pagina oficial de lancamentos no GitHub para baixar a versao mais recente do Sokuji para Linux.

Pacotes disponiveis

Pacote .deb - Para distribuicoes baseadas em Debian/Ubuntu
.AppImage - Pacote universal para todas as distribuicoes Linux
Pacote .rpm - Para distribuicoes baseadas em Fedora/RHEL (se disponivel)

Passo 2: Instalar pacote .deb (Ubuntu/Debian)

Se voce esta usando Ubuntu, Debian ou seus derivados, o pacote .deb e recomendado.

Metodo 1: Usando a interface grafica

Abra o gerenciador de arquivos e navegue ate a pasta Downloads
Clique duas vezes no arquivo sokuji_*.deb
Clique em "Instalar" na Central de Software que abre
Digite sua senha quando solicitado

Metodo 2: Usando o terminal

Abra o Terminal e execute os seguintes comandos:

cd ~/Downloads
sudo dpkg -i sokuji_*.deb

Se encontrar problemas de dependencia, corrija com:

sudo apt-get install -f

Passo 3: Instalar AppImage (Universal)

O AppImage funciona em todas as distribuicoes Linux e nao requer instalacao.

Configurar AppImage

Baixe o arquivo AppImage da pagina de lancamentos
Torne-o executavel:
```
chmod +x sokuji-*.AppImage
```
Execute o aplicativo:
```
./sokuji-*.AppImage
```

Opcional: Integracao com o sistema

Para integrar o AppImage com seu sistema:

mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji

Agora voce pode executar o Sokuji de qualquer lugar digitando sokuji no terminal.

Passo 4: Configuracao da primeira execucao

Ao iniciar o Sokuji pela primeira vez, voce precisara configura-lo:

Configuracao inicial

Inicie o Sokuji pelo menu de aplicativos ou terminal
Selecione seu idioma de interface preferido
Configure seu provedor de IA (OpenAI, Google Gemini, etc.)
Insira sua chave API para o provedor selecionado
Selecione seus dispositivos de microfone e alto-falantes
Teste o audio para garantir que tudo funcione

O Sokuji esta pronto para uso! Voce pode iniciar a traducao em tempo real clicando no botao de inicio de sessao.

Solucao de Problemas

Problemas de audio

Se voce tiver problemas de audio:

Certifique-se de que o PulseAudio ou PipeWire esteja em execucao: systemctl --user status pipewire
Verifique as permissoes de audio: groups $USER deve incluir 'audio'
Reinicie o servico de audio: systemctl --user restart pipewire

Permissao negada

Se voce receber erros de "Permission denied":

sudo usermod -a -G audio $USER

Em seguida, faca logout e login novamente para que as alteracoes entrem em vigor.

Dependencias ausentes

Instale as bibliotecas necessarias:

sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

AppImage nao executa

Se o AppImage nao executar, instale o FUSE:

sudo apt-get install fuse libfuse2

Para sistemas mais novos (Ubuntu 22.04+), voce pode precisar de:

sudo apt-get install libfuse2t64