> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Problemas de Entorno
> Solucionar problemas de entorno del sistema y configuracion
Soluciona problemas comunes relacionados con el entorno del sistema, shell y dependencias.
## PowerShell no reconocido
**Problema:** Mensaje de error "PowerShell no se reconoce como un comando interno o externo".
**Soluciones:**
* **Usuarios de Windows:**
* Agrega PowerShell al PATH del sistema
* Abre Configuracion → Sistema → Acerca de → Configuracion avanzada del sistema → Variables de entorno
* Agrega la ruta de PowerShell: `C:\Windows\System32\WindowsPowerShell\v1.0\`
* Reinicia SoloEnt despues de cambiar el PATH
* **Alternativa:**
* Usa el Simbolo del sistema (cmd) en su lugar
* Cambia el terminal predeterminado en Configuracion
* Reinstala PowerShell si falta
## Comando no encontrado
**Problema:** El terminal muestra "comando no encontrado" o errores similares.
**Soluciones:**
* Verifica que el comando/herramienta este instalado en tu sistema
* Comprueba si el comando esta en el PATH del sistema
* Reinicia el terminal despues de instalar nuevas herramientas
* Usa la ruta completa al ejecutable si es necesario
* Instala las dependencias faltantes
## Python/Node no encontrado
**Problema:** Los comandos de Python o Node.js no funcionan.
**Soluciones:**
* Instala Python desde python.org o Node.js desde nodejs.org
* Verifica la instalacion: `python --version` o `node --version`
* Agrega al PATH si esta instalado pero no se reconoce
* Reinicia SoloEnt despues de la instalacion
* Verifica conflictos de version (multiples versiones de Python/Node)
## Errores de permiso denegado
**Problema:** Errores de "Permiso denegado" o "Acceso denegado".
**Soluciones:**
* **macOS/Linux:**
* Usa `sudo` si es apropiado
* Verifica los permisos de archivo con `ls -la`
* Concede Acceso Completo al Disco en Configuracion del Sistema
* **Windows:**
* Ejecuta SoloEnt como Administrador si es necesario
* Verifica la configuracion de seguridad de la carpeta
* Desactiva temporalmente el Control de Cuentas de Usuario
## Ruta con espacios causa errores
**Problema:** Los comandos fallan cuando las rutas de archivo contienen espacios.
**Soluciones:**
* Encierra las rutas entre comillas: `"C:\Mis Documentos\proyecto"`
* Usa caracteres de escape en el terminal
* Evita espacios en los nombres de carpetas de proyectos
* Usa guiones o guiones bajos en su lugar: `mi-proyecto` no `mi proyecto`
## Git no disponible
**Problema:** Los comandos de Git no funcionan o Git no se encuentra.
**Soluciones:**
* Instala Git desde git-scm.com
* Verifica la instalacion: `git --version`
* Agrega Git al PATH del sistema
* Reinicia el terminal/SoloEnt despues de la instalacion
* Usa GitHub Desktop como alternativa
## Variables de entorno no configuradas
**Problema:** La aplicacion no puede encontrar las variables de entorno requeridas.
**Soluciones:**
* Configura las variables en la configuracion del sistema (no solo en la sesion del terminal)
* **Windows:** Propiedades del Sistema → Variables de entorno
* **macOS/Linux:** Agrega a `~/.zshrc` o `~/.bashrc`
* Reinicia SoloEnt despues de configurar las variables
* Verifica con `echo $NOMBRE_VARIABLE` (Unix) o `echo %NOMBRE_VARIABLE%` (Windows)
## Problemas de compatibilidad de shell
**Problema:** Los comandos funcionan en un shell pero no en otro.
**Soluciones:**
* Verifica que shell estas usando: `echo $SHELL`
* Cambia a un shell compatible (bash, zsh, PowerShell)
* Configura el shell predeterminado en la configuracion de SoloEnt
* Usa comandos multiplataforma cuando sea posible
## Desajuste de arquitectura del sistema
**Problema:** Herramientas o binarios incompatibles con tu sistema.
**Soluciones:**
* Verifica la arquitectura del sistema: `uname -m` (Unix) o `systeminfo` (Windows)
* Descarga la version correcta (x64, ARM64, etc.)
* Usa alternativas compatibles
* Habilita Rosetta 2 en Macs con Apple Silicon si es necesario
## Antivirus bloquea operaciones
**Problema:** El software antivirus interfiere con las operaciones de SoloEnt.
**Soluciones:**
* Agrega SoloEnt a la lista blanca/excepciones del antivirus
* Desactiva temporalmente el antivirus para probar
* Revisa los registros del antivirus para acciones bloqueadas
* Contacta al soporte del antivirus para la configuracion adecuada
## Problemas de espacio en disco
**Problema:** Las operaciones fallan debido a espacio insuficiente en disco.
**Soluciones:**
* Verifica el espacio disponible en disco
* Limpia archivos temporales y caches
* Mueve el proyecto a una unidad con mas espacio
* Elimina archivos innecesarios
## Problemas de red/firewall
**Problema:** No se puede conectar a servicios API o descargar actualizaciones.
**Soluciones:**
* Verifica la configuracion del firewall
* Permite SoloEnt a traves del firewall
* Configura los ajustes de proxy si estas detras de un firewall corporativo
* Prueba la conexion con una red diferente
* Contacta al departamento de TI para entornos empresariales
Muchos problemas de entorno se resuelven reiniciando SoloEnt despues de hacer cambios en el sistema como actualizaciones de PATH o instalar nuevas herramientas.
## Sigues teniendo problemas?
Contacta a nuestro equipo de soporte con detalles del entorno
Obtén ayuda de la comunidad
Volver a la guia de configuracion
## Reportar problemas de entorno
Al reportar problemas de entorno, incluye:
* **Sistema operativo**: Windows 10/11, version de macOS, distribucion de Linux
* **Arquitectura del sistema**: x64, ARM64, Apple Silicon
* **Tipo de shell**: PowerShell, CMD, bash, zsh
* **Mensajes de error**: Texto completo de cualquier error
* **Pasos intentados**: Lo que intentaste antes de reportar
Esta informacion nos ayuda a diagnosticar y resolver problemas mas rapidamente.