PermitNav is an engineering integration project that provides a rapidly deployable 3D navigation pipeline for the Unitree Go2-W robot using Livox MID360 LiDAR, ROS2 Humble, FAST-LIO, and jie_3d_nav.

Stars

38

7-day growth

No data

Forks

3

Open issues

0

License

Apache-2.0

Last updated

2026-07-06

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines multiple state-of-the-art open-source packages into a working real-robot navigation demo, with detailed hardware setup, network configuration, and step-by-step instructions, demonstrating a short-cycle engineering integration approach.

Who it is for

  • Unitree Go2-W owners seeking autonomous navigation
  • Robotics researchers needing a reference ROS2 navigation pipeline
  • Hobbyists integrating Livox MID360 with ROS2
  • Engineers evaluating real-time 3D navigation on quadruped robots

Use cases

  • Autonomous 3D navigation of Go2-W in indoor environments
  • Real-time mapping and localization with FAST-LIO and relocalization
  • Web-based goal setting and path planning via jie_3d_nav
  • Educational demonstration of integrating LiDAR, odometry, and control on a real robot

Strengths

  • Complete end-to-end pipeline from sensor data to robot motion, validated on real hardware
  • Clear network and IP configuration for dual subnet communication
  • Detailed build and troubleshooting sections reduce setup friction
  • Leverages well-tested open-source libraries (FAST-LIO, Livox SDK2, jie_3d_nav)

Considerations

  • Not a generic navigation framework; tightly coupled to specific hardware (Go2-W, MID360, NUC)
  • Assumes robot starts near the map origin and requires manual PC-side map processing
  • Potential localization drift mentioned; restarting the system is suggested as first troubleshooting step

README quick start

PermitNav for Go2-W

PermitNav is a rapidly integrated 3D navigation demo for Unitree Go2-W / Go2W, built with Livox MID360, ROS2 Humble, FAST-LIO, FAST_LIO_LOCALIZATION2, jie_3d_nav, and Unitree SDK2.

The name PermitNav comes from the original motivation of this project: building a working real-robot navigation demo in a very short time to prove that the system could run and to earn permission to leave for an internship.

This project is mainly intended to achieve a basic 3D navigation pipeline on a real Go2-W robot. It is an engineering integration project rather than a from-scratch navigation framework. This project is only meant to achieve a basic 3D navigation demo. My main focus is locomotion, and I have not worked much on navigation before. If bugs appear, restarting the system is probably the best first solution.

Video: 【【开源】PermitNav,缝合速成的一种全局3d导航】 https://www.bilibili.com/video/BV12Y7j6iEHi/?share_source=copy_web&vd_source=b5c22f93b0d2fd36b1d6203208bd650b

The NUC side is responsible for:

MID360 data acquisition
  ↓
FAST-LIO mapping / real-time odometry
  ↓
FAST_LIO_LOCALIZATION2 global localization
  ↓
localization bridge publishing map -> base_link
  ↓
jie_3d_nav Web planning and controller
  ↓
go2w_cmd_bridge forwarding /cmd_vel to Go2-W

Default workspace:

~/go2w_nav_ws

Acknowledgements

This project is not a navigation framework implemented from scratch. It is a real-robot ROS2 navigation integration project built quickly on top of existing open-source projects.

We sincerely thank the authors and maintainers of the following projects:

Open-source projectUsage in this project
Livox-SDK2Low-level Livox LiDAR SDK used to receive data from MID360 and other Livox LiDARs.
livox_ros_driver2ROS/ROS2 driver for Livox LiDARs. In this project, it publishes MID360 point cloud and IMU data.
FAST_LIO_ROS2ROS2 version of FAST-LIO. Used for LiDAR-inertial odometry, real-time mapping, /Odometry, and registered point cloud publishing.
FAST_LIO_LOCALIZATIONFAST-LIO based localization framework. In this project, it is adapted for relocalization in a pre-

Description

A rapid ROS2 3D navigation integration for Unitree Go2-W with Livox MID360.

Related repositories

Similar projects matched by category, topics, and programming language.

alecjacobson
Featured
alecjacobson GitHub avatar

alpha-wrap

A CGAL-free, MIT-licensed reimplementation of the Alpha Wrapping algorithm that takes a defective triangle soup and produces a watertight, manifold, outward-oriented mesh with controllable level of detail and tightness.

C++
4
hypervising
Featured
hypervising GitHub avatar

gta-enhanced-audio-queue-poc

A proof-of-concept tool that patches a synchronous three-slot audio queue in GTA V Enhanced, boosting frame rates from ~260 to ~499 FPS by removing coarse wait delays.

Design & Creative
3
ammaarreshi
ammaarreshi GitHub avatar

Generals-Mac-iOS-iPad

This repository ports Command & Conquer Generals: Zero Hour to run natively on Apple Silicon Macs, iPhones, and iPads without emulation, adding touch controls and modern rendering.

C++
1,523