micro-ROS Agent on macOS

Open

#269 opened on Apr 15, 2026 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 4/5
Estimated time: 3-5 days
Newbie friendliness: 35/100

Issue type: Feature
Clarity: Needs clarification
Activity status: Quiet
Tech stack: docker, macos
Domain: devops, embedded-iot, networking

Research direction

Reproduce the shown docker run command with Docker Desktop on macOS and compare it with the successful Ubuntu result. Investigate whether the agent's UDP connection is supported through Docker's macOS networking; done would be a confirmed macOS procedure or a documented incompatibility.

Written by the indexing model from the issue text.

Description

I hope to run micro-ROS Agent on macOS. Is there a way?

[macOS PC]<----- Wi-Fi ----->[ATOM Matrix]

Step1

I flashed https://github.com/micro-ROS/micro_ros_arduino/blob/kilted/examples/micro-ros_publisher_wifi/micro-ros_publisher_wifi.ino to ATOM Matrix.

Step2

I tried to use official Docker image.
And, I used Docker Desktop on Mac.

docker run -it --rm --net=host microros/micro-ros-agent:jazzy udp4 -p 8888

As a result, the following message was displayed.

[1776208951.161796] info     | UDPv4AgentLinux.cpp | init                     | running...             | port: 8888
[1776208951.161960] info     | Root.cpp           | set_verbose_level        | logger setup           | verbose_level: 4
[1776209018.862533] info     | Root.cpp           | create_client            | create                 | client_key: 0x5A53D35F, session_id: 0x81
[1776209018.862722] info     | SessionManager.hpp | establish_session        | session established    | client_key: 0x5A53D35F, address: 127.0.0.1:58347
[1776209019.779195] info     | SessionManager.hpp | establish_session        | session re-established | client_key: 0x5A53D35F, address: 127.0.0.1:58347
[1776209020.702419] info     | SessionManager.hpp | establish_session        | session re-established | client_key: 0x5A53D35F, address: 127.0.0.1:58347

Additional information

I could run micro-ROS Agent on Ubuntu PC.

docker run -it --rm --net=host microros/micro-ros-agent:jazzy udp4 -p 8888

Dominant language: C++
Stars: 201
Forks: 111
Avg merge: 1d 6h
Merged PRs (30d): 10

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

[Bug] NULL pointer dereference in llm_running_callback (NGZA-AX-LLM #3) Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

AXERA-TECH/ax-llm#77 · Opened Sep 22, 2026
resume() sends a second HTTP response (400) after a successful resume Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

games-on-whales/wolf#509 · Opened Sep 21, 2026
z3.py omits additional domains of multidimensional arrays during printing Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

Z3Prover/z3#10889 · Opened Sep 21, 2026
pn7160: reader goes permanently deaf — post-read IRQ-low check fails reads that succeeded Open

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

esphome/esphome#19452 · Opened Sep 21, 2026
Eval bug: Ministral-3 tool-calls during reasoning are not processed Open

bug-unconfirmed

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

ggml-org/llama.cpp#29248 · Opened Sep 21, 2026

More C++ issues