Development Guide

July 8, 2026 · View on GitHub

Setup

git clone https://github.com/OpenHands/software-agent-sdk.git
cd software-agent-sdk
make build

Code Quality

make format                              # Format code
make lint                                # Lint code
uv run pre-commit run --all-files        # Run all checks

Pre-commit hooks run automatically on commit with type checking and linting.

Testing

uv run pytest                            # All tests
uv run pytest tests/sdk/                 # SDK tests only
uv run pytest tests/tools/               # Tools tests only

Project Structure

software-agent-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

Contributing

  1. Create a new branch
  2. Make your changes
  3. Run tests and checks
  4. Push and create a pull request

For questions, join our Slack community.