Installation（安装）

本页是安装摘要，唯一事实源为：

• INSTALL.md

Note

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

1. 克隆与准备

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 环境

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 环境（可选）

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. 验证

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