feat: Add LocalRuntime

[xingyaoww]

This PR adds a new LocalRuntime implementation and renames EventStreamRuntime to LocalDockerRuntime for better clarity.

Changes

• Add new LocalRuntime implementation that runs action_execution_server directly on the host machine
• Rename EventStreamRuntime to LocalDockerRuntime for better clarity
• Move runtime implementations to dedicated directories (local/ and docker/)
• Update documentation to reflect runtime changes and add LocalRuntime description

Benefits

• Provides a simpler setup for users who don't need container isolation
• Clearer naming convention for runtime implementations
• Better organized codebase with dedicated directories for each runtime type
• Updated documentation to help users choose the right runtime for their needs

---

Issue fixed: https://github.com/orgs/All-Hands-AI/projects/1?pane=issue&itemId=82616729&issue=All-Hands-AI%7COpenHands%7C3903

---

To run this PR locally, use the following command:

docker run -it --rm   -p 3000:3000   -v /var/run/docker.sock:/var/run/docker.sock   --add-host host.docker.internal:host-gateway   -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:350e1bb-nikolaik   --name openhands-app-350e1bb   docker.all-hands.dev/all-hands-ai/openhands:350e1bb

[github-actions]

OpenHands started fixing the pr! You can monitor the progress here.

[openhands-agent]

New OpenHands update

[enyst]

@openhands-agent This PR tests fail with

File "/home/runner/work/OpenHands/OpenHands/openhands/runtime/init.py", line 3, in
from openhands.runtime.impl.eventstream.eventstream_runtime import (

ERROR:root:<class 'ModuleNotFoundError'>: No module named 'openhands.runtime.impl.eventstream'

Fix this error. Keep your changes minimal.

[github-actions]

OpenHands started fixing the pr! You can monitor the progress here.

[enyst]

@openhands-agent We have done a lot to fix the original. This PR is doing these:

• Add new LocalRuntime implementation that runs action_execution_server directly on the host machine
• Rename EventStreamRuntime to DockerRuntime for better clarity
• Move runtime implementations to dedicated directories (local/ and docker/)
• Update documentation to reflect runtime changes and add LocalRuntime description.

The PR is mostly finished now. It has only one detail that went wrong: instead of the name LocalDockerRuntime, we now want the name DockerRuntime. Find all occurrences and fix them. Additionally, look also for the name EventStreamRuntime, and if you find any, update it to the new name, DockerRuntime.

[github-actions]

OpenHands started fixing the pr! You can monitor the progress here.

[xingyaoww]

For some reason i cannot get these LocalRuntime tests to run in CI 😓 but they pass locally, and the test runs extremely slow in CI - maybe we could ask review for this PR as is, and add tests later? We probably should make this as some sort of highly experimental feature, and YMMV

[enyst]

@xingyaoww I agree. I fought them too, and yes, I can confirm they can work locally on Mac.

If you could take a look in conversations tab on github, it has some minor thoughts about errors/exceptions that I thought maybe we can discuss?

[scosenza]

I just wanted to thank you again for working on this PR! We've been regularly pulling this branch, and the local mode has been running great for us on Linux machines! 🙌

[xingyaoww]

Thanks @enyst for the comments! I believe I should've addressed them -- LMK if you have any other question/concerns here. This is ready for another review :)

[enyst]

Thank you so much for this!

*makes a backup of the local machine

Let the fun begin 😂

[xingyaoww]

*makes a backup of the local machine

This actually makes actually think we should add this to the warning lol

[czq99972]

@xingyaoww How should I start a service locally using the Local Runtime instead of Docker Runtime? What are the specific commands and steps for executing this?

[enyst]

All I had to do to use it is to set the runtime type to local in config.toml (e.g. like the template shows here.

But best use is probably not local exactly, but on another machine than your machine, due to the risk. The LLM really can do anything under your user.

[czq99972]

All I had to do to use it is to set the runtime type to local in config.toml (e.g. like the template shows here.

But best use is probably not local exactly, but on another machine than your machine, due to the risk. The LLM really can do anything under your user.

Thank you, I will try to run it.