Instalação¶

O Apogee Framework é distribuído como um único binário standalone construído com PyInstaller. Você não precisa instalar dependências Python na sua máquina para usá-lo — apenas Python 3.11+ para os projetos que você gerar.

Pré-requisitos¶

Python 3.11+ (para os projetos gerados, não para o apogee em si)
Docker e Docker Compose v2 (para apogee up)
make (para build a partir do código)
Linux ou macOS (Windows: WSL2 recomendado)

Opção A — Build a partir do código¶

Caminho suportado enquanto o framework está pré-1.0.

Bash

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

# build local em .dist/apogee
make build

# instala globalmente em /usr/local/bin/apogee (ou ~/.local/bin)
make install

Após instalar, verifique:

Bash

apogee --version
apogee --help

Opção B — Rodar a partir do código sem instalar¶

Útil para desenvolvimento no próprio framework.

Bash

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

Opção C — Binário pré-compilado (em breve)¶

Binários pré-compilados para Linux/macOS serão publicados em GitHub Releases após a marca 1.0.

Verifique a instalação¶

Bash

apogee --version
# → 0.2.0 (ou mais recente)

Próximo passo¶

→ Gere seu primeiro projeto: Início rápido.