mirror of
https://github.com/OpenHands/OpenHands.git
synced 2025-12-26 05:48:36 +08:00
74 lines
1.7 KiB
Plaintext
74 lines
1.7 KiB
Plaintext
---
|
|
title: Debugging
|
|
---
|
|
|
|
The following is intended as a primer on debugging OpenHands for Development purposes.
|
|
|
|
## Server / VSCode
|
|
|
|
The following `launch.json` will allow debugging the agent, controller and server elements, but not the sandbox (Which runs inside docker). It will ignore any changes inside the `workspace/` directory:
|
|
|
|
```
|
|
{
|
|
"version": "0.2.0",
|
|
"configurations": [
|
|
{
|
|
"name": "OpenHands CLI",
|
|
"type": "debugpy",
|
|
"request": "launch",
|
|
"module": "openhands.cli.main",
|
|
"justMyCode": false
|
|
},
|
|
{
|
|
"name": "OpenHands WebApp",
|
|
"type": "debugpy",
|
|
"request": "launch",
|
|
"module": "uvicorn",
|
|
"args": [
|
|
"openhands.server.listen:app",
|
|
"--reload",
|
|
"--reload-exclude",
|
|
"${workspaceFolder}/workspace",
|
|
"--port",
|
|
"3000"
|
|
],
|
|
"justMyCode": false
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
More specific debugging configurations which include more parameters may be specified:
|
|
|
|
```
|
|
...
|
|
{
|
|
"name": "Debug CodeAct",
|
|
"type": "debugpy",
|
|
"request": "launch",
|
|
"module": "openhands.core.main",
|
|
"args": [
|
|
"-t",
|
|
"Ask me what your task is.",
|
|
"-d",
|
|
"${workspaceFolder}/workspace",
|
|
"-c",
|
|
"CodeActAgent",
|
|
"-l",
|
|
"llm.o1",
|
|
"-n",
|
|
"prompts"
|
|
],
|
|
"justMyCode": false
|
|
}
|
|
...
|
|
```
|
|
|
|
Values in the snippet above can be updated such that:
|
|
|
|
* *t*: the task
|
|
* *d*: the openhands workspace directory
|
|
* *c*: the agent
|
|
* *l*: the LLM config (pre-defined in config.toml)
|
|
* *n*: session name (e.g. eventstream name)
|