Instalación Local y Configuración de Python
Detalles técnicos para preparar un entorno de desarrollo funcional en computadoras de escritorio, instalar el paquete LangPy mediante PIP y ejecutar laboratorios de código nativo en español.
1. Verificación del Intérprete de Python
Para garantizar la transpilación léxica de los módulos, se requiere Python 3.10 o superior instalado en el sistema operativo local.
Debe comprobar la presencia y la versión del intérprete ejecutando la siguiente instrucción desde su terminal de comandos de preferencia:
- Windows: python --version
- macOS / Linux: python3 --version
Si la terminal indica que el comando no es reconocido o si la versión reportada es obsoleta, descargue la última versión estable desde el sitio oficial python.org. En sistemas Windows, es imperativo tildar la opción "Add Python to PATH" durante el instalador para indexar el ejecutable en las variables globales.
2. Configuración del Entorno Virtual (Recomendado)
El uso de entornos virtuales (`venv`) es la práctica estándar en la industria y en laboratorios educativos para aislar los paquetes de cada proyecto, previniendo conflictos de dependencias con el sistema base.
Creación del entorno
Abra la terminal en el directorio asignado para su espacio de trabajo o laboratorio escolar y ejecute:
- Windows: python -m venv venv
- macOS / Linux: python3 -m venv venv
Activación
Para asegurarse de que el paquete se instale dentro del contenedor del proyecto, active el entorno según su sistema:
- Windows (Símbolo del Sistema / CMD): venv\Scripts\activate
- Windows (PowerShell): .\venv\Scripts\Activate.ps1
- macOS / Linux: source venv/bin/activate
3. Instalación desde el Gestor PIP
Con el entorno virtual debidamente activado en la consola, descargue la última versión estable del transpilador oficial.
pip install langpy
Este paquete añade las herramientas léxicas locales necesarias para mapear las instrucciones lógicas en español a código nativo compatible directamente con cualquier script o librería estándar de Python.
4. Creación y Ejecución de Scripts Locales
El entorno de LangPy utiliza la extensión de archivo `.pyes` para agrupar los archivos fuente escritos con semántica en español.
- Abra cualquier editor de código limpio de su preferencia (ej. VS Code, VSCodium, Kate o un bloc de notas estándar).
- Cree un archivo de texto en blanco y guarde su estructura con el nombre `main.pyes`.
- Escriba la siguiente instrucción inicial de verificación en su editor:
imprimir("Hola desde LangPy local")Ejecución desde Consola
A diferencia de los scripts planos tradicionales de Python, el intérprete en español se invoca llamando de forma directa al comando raíz instalado:
langpy main.pyes
El núcleo de LangPy resolverá la traducción semántica en tiempo real y enviará la estructura de forma directa a la máquina virtual local de Python, asegurando el mismo desempeño de rendimiento original.
Resolución de Errores Comunes de Entorno
Durante la configuración de laboratorios informáticos o primeros entornos locales es común toparse con bloqueos de permisos. Aquí los diagnósticos y correcciones directas.
Python o pip no se reconocen como comandos del sistema
La consola de comandos indica que el término ingresado no corresponde a un programa ejecutable.
El instalador inicial omitió exportar las rutas binarias a las variables de entorno de la máquina (PATH).
Vuelva a lanzar el instalador oficial de Python para su plataforma, elija la opción de modificar o reparar la instalación y verifique que la casilla "Add Python to PATH" quede completamente marcada antes de finalizar.
Restricción de políticas de ejecución (Error en Windows PowerShell)
Al intentar correr el comando de activación del entorno virtual local, PowerShell despliega una advertencia roja de seguridad bloqueando el proceso.
El sistema de seguridad por defecto de Windows previene la ejecución de scripts locales que no cuenten con firmas remotas dentro de la consola.
Otorgue permisos temporales ejecutando la siguiente instrucción con privilegios en su PowerShell: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
El binario 'langpy' no se localiza en la terminal
La consola despliega que la orden de ejecución no existe a pesar de haber descargado el paquete previamente.
La terminal actual perdió la referencia del entorno virtual activo o la instalación global carece de accesos.
Asegúrese de visualizar la etiqueta de su entorno activo entre paréntesis al inicio de la línea de comandos, actualice los componentes principales e intente una reinstalación forzada con: python -m pip install --upgrade pip && pip install langpy
Incompatibilidades en tiempo de ejecución
El sistema levanta excepciones inesperadas al procesar un archivo con extensión legítima .pyes.
La versión del intérprete de Python de la máquina anfitriona es anterior a los estándares técnicos mínimos del transpilador.
Ejecute en su terminal el comando `python --version` para validar su entorno y proceda a migrar el sistema hacia una versión moderna igual o superior a Python 3.10.