Instalación¶

El Apogee Framework se distribuye como un único binario autónomo construido con PyInstaller. No necesitas instalar dependencias Python en tu máquina para usarlo — solo Python 3.11+ para los proyectos que generes.

Requisitos previos¶

Python 3.11+ (para los proyectos generados, no para apogee en sí)
Docker y Docker Compose v2 (para apogee up)
make (para compilar desde el código)
Linux o macOS (Windows: WSL2 recomendado)

Opción A — Compilar desde el código¶

Camino soportado mientras el framework está pre-1.0.

Bash

git clone https://github.com/Digital-Codigos/apogee-framework
cd apogee-framework

make build      # compila en .dist/apogee
make install    # instala globalmente en /usr/local/bin/apogee

Verificación:

Bash

apogee --version
apogee --help

Opción B — Ejecutar desde el código sin instalar¶

Útil para desarrollo del propio framework.

Bash

PYTHONPATH="src" python3 -m presentation.cli --help

Opción C — Binario precompilado (próximamente)¶

Los binarios precompilados para Linux/macOS se publicarán en GitHub Releases después de la marca 1.0.

Próximo paso¶

→ Genera tu primer proyecto: Inicio rápido.