git clone https://github.com/OpenHands/agent-sdk.git
cd agent-sdk
make buildmake format # Format code
make lint # Lint code
uv run pre-commit run --all-files # Run all checksPre-commit hooks run automatically on commit with type checking and linting.
uv run pytest # All tests
uv run pytest tests/sdk/ # SDK tests only
uv run pytest tests/tools/ # Tools tests onlyagent-sdk/
├── openhands-sdk/ # Core SDK package
├── openhands-tools/ # Built-in tools
├── openhands-workspace/ # Workspace management
├── openhands-agent-server/ # Agent server
├── examples/ # Usage examples
└── tests/ # Test suites
- Create a new branch
- Make your changes
- Run tests and checks
- Push and create a pull request
For questions, join our Slack community.