openhands-tools
OpenHands Tools - Runtime tools for AI agents
Decision gist · record as of 2026-08-14
Yes, if you need to build AI-powered code automation workflows. The package is actively maintained, has low install friction, and sits in the top 5000 PyPI packages by download volume. The main gotchas are the Python 3.12 requirement and the unclear license status—verify the license terms before using in proprietary contexts. No known security vulnerabilities as of the query date.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- LLM API credentials must be provided at runtime.
- Active maintenance with a recent release (2 days old) and steady repository activity.
License · maintenance · safety
(unclear) — License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.
last release 2026-08-12 (2 days) · last repo commit 2026-08-14 · 987 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 10,358,435 downloads/mo, #1,456 on PyPI
Alternatives
Verify before relying
pip install openhands-tools
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.terminal import TerminalTool
llm = LLM(api_key="your-key")
agent = Agent(llm=llm, tools=[Tool(name=TerminalTool.name)])
conversation = Conversation(agent=agent, workspace=".")
conversation.send_message("List files in current directory")
conversation.run()- Whether the package supports streaming or async agent execution patterns.
- Specific constraints or latency characteristics when running agents in ephemeral workspaces.
- Whether custom tools can be authored without modifying the SDK itself.
- Support for non-OpenAI LLM providers beyond documented examples.
What it is and what it does
OpenHands Tools is a Python SDK for building AI agents that can read, write, and execute code in a workspace. It wraps an LLM with a set of built-in tools (file editor, terminal, task tracker, browser automation) and manages agent-workspace interactions, supporting both local execution and remote ephemeral environments. The package is part of the OpenHands ecosystem and serves as the foundation for the OpenHands CLI and Cloud platform.
The SDK is designed for developers who want to automate code-related tasks—from generating documentation to refactoring entire codebases—by composing agents with different tool combinations. It handles the orchestration between the LLM, the tools, and the workspace, abstracting away the complexity of agent lifecycle management. The package depends on tree-sitter for code parsing, pydantic for validation, browser-use for web automation, and several utility libraries.
Use it for
- Generate or update project documentation (READMEs, API docs) automatically from code.
- Automate routine maintenance like dependency updates or code formatting across a repository.
- Build multi-agent workflows for large refactors or architectural rewrites.
- Integrate AI-driven code automation into CI/CD pipelines via GitHub Workflows.
- Create custom developer tools or IDE plugins powered by code-aware agents.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to build AI-powered code automation workflows.
The package is actively maintained, has low install friction, and sits in the top 5000 PyPI packages by download volume. The main gotchas are the Python 3.12 requirement and the unclear license status—verify the license terms before using in proprietary contexts. No known security vulnerabilities as of the query date.
Install
openhands-tools on PyPI
Before you install
Active maintenance with a recent release (2 days old) and steady repository activity. Low install friction with a pure-Python wheel. Requires Python 3.12 or later, which is a moderate constraint for older projects.
Requires Python 3.12 or later. LLM API credentials must be provided at runtime.
License in practice
License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or restricted contexts.
Quickstart
pip install openhands-tools
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.terminal import TerminalTool
llm = LLM(api_key="your-key")
agent = Agent(llm=llm, tools=[Tool(name=TerminalTool.name)])
conversation = Conversation(agent=agent, workspace=".")
conversation.send_message("List files in current directory")
conversation.run()Verify before relying
- Whether the package supports streaming or async agent execution patterns.
- Specific constraints or latency characteristics when running agents in ephemeral workspaces.
- Whether custom tools can be authored without modifying the SDK itself.
- Support for non-OpenAI LLM providers beyond documented examples.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 10 packagesopenhands-sdktree-sittertree-sitter-bashbinaryornotcachetoolslibtmuxpydanticbrowser-usefunc-timeouttom-swe |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 10,358,435 / month, #1,456 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: openhands_tools-1.42.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “ai agent sdk for code”
- openhands-toolsProvides Python and REST APIs for building AI agents that work with…
- openhands-sdkOpenHands SDK provides Python and REST APIs for building software…
- openhands-workspaceProvides Python and REST APIs for building software agents that can…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also openhands-sdk · openhands-workspace · openhands-aci · openhands-agent-server · openhands · openhands-ai · tooluniverse · cursor-sdk · openai-codex · pyral