跳转至

安装

Apogee 框架通过 PyInstaller 构建为**单个独立二进制文件**分发。使用它无需在机器上安装 Python 依赖项 — 仅生成项目时需要 Python 3.11+。

前置条件

  • Python 3.11+（用于生成的项目，而非 apogee 本身）
  • Docker 和 Docker Compose v2（用于 apogee up）
  • make（用于从源码构建）
  • Linux 或 macOS（Windows 用户：建议使用 WSL2）

选项 A — 从源码构建

框架在 1.0 之前的支持路径。

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

make build      # 在 .dist/apogee 构建本地二进制
make install    # 全局安装到 /usr/local/bin/apogee

验证：

Bash
apogee --version
apogee --help

选项 B — 不安装直接从源码运行

适用于框架本身的开发。

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

选项 C — 预编译二进制（即将推出）

Linux/macOS 的预编译二进制将在达到 1.0 里程碑后发布到 GitHub Releases。

下一步

→ 生成你的第一个项目：快速开始。