# Installation（安装）

本页是安装摘要，唯一事实源为：
- [INSTALL.md](https://github.com/Royalvice/OmniNav/blob/main/INSTALL.md)

```{note}
若本页与实际安装过程有差异，请优先以 `INSTALL.md` 为准。
```

## 1. 克隆与准备

```bash
git clone https://github.com/Royalvice/OmniNav.git
cd OmniNav

git lfs install
git submodule update --init external/Genesis
git submodule update --init external/genesis_ros

cd external/Genesis
git submodule update --init doc
cd ../..

git lfs pull
```

## 2. 纯 Python 环境

```bash
python3 -m venv .venv
source .venv/bin/activate

pip install --upgrade pip
pip3 install torch torchvision --index-url https://download.pytorch.org/whl/cuxxx
pip install -r requirements.txt
pip install -e .
```

```{tip}
`examples/getting_started` 目录下的入口建议使用 `python -m` 方式启动：
`python -m examples.getting_started.run_getting_started`
```

## 3. ROS2/Nav2 环境（可选）

```bash
sudo apt update
sudo apt install -y \
  ros-humble-desktop \
  ros-humble-navigation2 \
  ros-humble-nav2-bringup

python3 -m venv --system-site-packages ~/omninav_ros_env
source ~/omninav_ros_env/bin/activate
source /opt/ros/humble/setup.bash
```

```{warning}
ROS2 场景中，务必在同一个终端中同时完成 Python 环境激活与 ROS2 `setup.bash` 加载，再启动示例。
```

## 4. 验证

```bash
python -c "import omninav; print('omninav import ok')"
python examples/05_waypoint_navigation.py --test-mode --smoke-fast --max-steps 40 --no-show-viewer
```