← Volver a la documentacion

Guia de instalacion en Linux

Esta guia le ayudara a instalar Sokuji en sistemas Linux. Sokuji esta disponible como paquete .deb para distribuciones basadas en Debian/Ubuntu y como AppImage para compatibilidad universal.

Descargar para Linux

Requisitos del sistema

  • Ubuntu 20.04 o posterior, Debian 10 o posterior, o distribucion equivalente
  • Procesador de 64 bits
  • 4GB de RAM minimo (8GB recomendado)
  • 100MB de espacio en disco disponible
  • PulseAudio o PipeWire para soporte de audio
  • Conexion a internet para servicios de IA

Pasos de instalacion

Paso 1: Descargar Sokuji

Visite la pagina oficial de lanzamientos en GitHub para descargar la ultima version de Sokuji para Linux.

Paquetes disponibles

  • Paquete .deb - Para distribuciones basadas en Debian/Ubuntu
  • .AppImage - Paquete universal para todas las distribuciones Linux
  • Paquete .rpm - Para distribuciones basadas en Fedora/RHEL (si esta disponible)

Paso 2: Instalar paquete .deb (Ubuntu/Debian)

Si usa Ubuntu, Debian o sus derivados, se recomienda el paquete .deb.

Metodo 1: Usando la interfaz grafica

  1. Abra su administrador de archivos y navegue a la carpeta de Descargas
  2. Haga doble clic en el archivo sokuji_*.deb
  3. Haga clic en "Instalar" en el Centro de Software que se abre
  4. Ingrese su contrasena cuando se le solicite

Metodo 2: Usando la terminal

Abra la Terminal y ejecute los siguientes comandos: 
cd ~/Downloads
sudo dpkg -i sokuji_*.deb
Si encuentra problemas de dependencias, corrija con: 
sudo apt-get install -f

Paso 3: Instalar AppImage (Universal)

AppImage funciona en todas las distribuciones Linux y no requiere instalacion.

Configurar AppImage

  1. Descargue el archivo AppImage de la pagina de lanzamientos
  2. Hagalo ejecutable: 
    chmod +x sokuji-*.AppImage
  3. Ejecute la aplicacion: 
    ./sokuji-*.AppImage

Opcional: Integracion con el sistema

Para integrar la AppImage con su sistema: 
mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji
Ahora puede ejecutar Sokuji desde cualquier lugar escribiendo sokuji en la terminal.

Paso 4: Configuracion del primer inicio

Al iniciar Sokuji por primera vez, necesitara configurarlo:

Configuracion inicial

  1. Inicie Sokuji desde el menu de aplicaciones o la terminal
  2. Seleccione su idioma de interfaz preferido
  3. Configure su proveedor de IA (OpenAI, Google Gemini, etc.)
  4. Ingrese su clave API para el proveedor seleccionado
  5. Seleccione sus dispositivos de microfono y altavoces
  6. Pruebe el audio para asegurarse de que todo funcione
Sokuji esta listo para usar. Puede iniciar la traduccion en tiempo real haciendo clic en el boton de inicio de sesion.

Solucion de problemas

Problemas de audio

Si experimenta problemas de audio:
  • Asegurese de que PulseAudio o PipeWire este ejecutandose: systemctl --user status pipewire
  • Verifique los permisos de audio: groups $USER deberia incluir 'audio'
  • Reinicie el servicio de audio: systemctl --user restart pipewire

Permiso denegado

Si obtiene errores de "Permission denied": 
sudo usermod -a -G audio $USER
Luego cierre sesion y vuelva a iniciarla para que los cambios surtan efecto.

Dependencias faltantes

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

AppImage no se ejecuta

Si AppImage no se ejecuta, instale FUSE: 
sudo apt-get install fuse libfuse2
Para sistemas mas nuevos (Ubuntu 22.04+), podria necesitar: 
sudo apt-get install libfuse2t64