Skip to content

Add Pixi instructions to local installation - #999

Draft
mini-1235 wants to merge 1 commit into
ros-navigation:rollingfrom
mini-1235:add-pixi-install-instructions
Draft

mini-1235 wants to merge 1 commit into
ros-navigation:rollingfrom
mini-1235:add-pixi-install-instructions

Conversation

@mini-1235

Copy link
Copy Markdown
Collaborator

Basic Info

Info Please fill out this column
Ticket(s) this addresses Companion PR for ros-navigation/navigation2#6722
Does this PR contain AI-generated software? Yes, reviewed by me

Description of contribution in a few bullet points

  • Added a "Nav2 from Source with Pixi" tab to the local installation page, covering how to build, launch the TurtleBot 4 simulation, run the tests and switch distributions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: mini-1235 <mauricepurnawan@gmail.com>
@mini-1235
mini-1235 marked this pull request as draft November 1, 2026 17:59
@mini-1235

Copy link
Copy Markdown
Collaborator Author

Draft until ros-navigation/navigation2#6722 is ready


For more examples on building Nav2 from rolling development source, checkout [distro.Dockerfile](https://github.com/ros-navigation/navigation2/blob/main/tools/distro.Dockerfile).

=== "Nav2 from Source with Pixi"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This seems like it should be its own page next to local install / docker install for 'pixi installation'

https://docs.nav2.org/rolling/getting_started/build_and_install/

curl -fsSL https://pixi.sh/install.sh | sh
git clone https://github.com/ros-navigation/navigation2.git --branch main
cd navigation2
pixi run -e rolling build

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it implied that you can then also do jazzy/kilted/lyrical/etc here for build as well? Making that explicit would be nice

You can then launch the TurtleBot 4 simulation with Nav2, forwarding any launch arguments:

```bash
pixi run -e rolling tb4-sim

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about running arbitrary launch files? Some more instruction for how to get in the pixi environment and use it would be good. This may well be many people's first time running into pixi so giving a quick rundown of some commonly useful commands would be good.

  • Run the nav2 main launch file(s)
  • Getting into the environment to rostopic echo some topics or something
  • Introducing that there are some named endpoints it seems that you have created like this tb4-sim. I think these endpoints should be named inline with the launch files themselves though so that there's a 1:1 recognition

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants