The OpenHands Software Agent SDK is a set of Python and REST APIs for building agents that work with code, suitable for one-off tasks, routine maintenance, and major refactoring operations.
One-Minute Overview#
The OpenHands Software Agent SDK is a clean, modular SDK for building AI agents with OpenHands V1. It provides Python and REST APIs for creating code-aware intelligent agents that can handle everything from simple tasks to complex refactoring operations.
Core Value: Provides a unified framework for building AI agents that understand and manipulate code, significantly improving development efficiency
Quick Start#
Installation Difficulty: Medium - Requires basic Python knowledge and understanding of LLMs
# Typical installation command
pip install openhands-sdk
Is this suitable for my scenario?
- ✅ Projects requiring auto-generated README or documentation
- ✅ Routine maintenance tasks like dependency updates
- ✅ Large refactoring operations involving multiple agents
- ❌ Simple AI applications that only process text without code manipulation
Core Capabilities#
1. Agent Tool Integration - File System Operations#
- Provides FileEditorTool enabling agents to read, create, and modify files
- Includes TerminalTool for command line execution Actual Value: Agents can execute tasks directly in the project environment without manual intervention
2. Conversational Interaction - Natural Language Task Processing#
- Manages agent-user interactions through the Conversation class
- Supports sending task instructions in natural language that agents understand and execute Actual Value: Developers can use natural language rather than complex configurations to describe tasks
3. Multi-workspace Support - Flexible Execution Environment#
- Can run agents on the local machine
- Can also run in ephemeral workspaces (Docker or Kubernetes) Actual Value: Ensures isolation while supporting both local and cloud-native deployments
Tech Stack & Integration#
Development Languages: Python (96.7%), JavaScript (1.1%), HTML (0.8%), Jinja (0.8%), CSS (0.3%) Main Dependencies: LLM providers (e.g., Anthropic), file system tools, terminal tools Integration Method: API / SDK / Library
Maintenance Status#
- Development Activity: Actively maintained - Latest version v1.9.1, 926 commits, 55 contributors
- Recent Updates: Frequent releases with stable new versions
- Community Response: Active - 104 open issues, 62 pull requests
Documentation & Learning Resources#
- Documentation Quality: Comprehensive - Includes getting started guide, architecture concepts, tutorials, and API reference
- Official Documentation: https://docs.openhands.dev/sdk
- Example Code: Available - examples/ directory with three main categories: standalone SDK, remote agent server, and GitHub workflows