openhands-workspace
OpenHands Workspace - Docker and container-based workspace implementations
Decision gist · record as of 2026-08-14
Yes, if you need to build LLM-powered agents that can work with code. The package is actively maintained, has low install friction, and a clear use case. However, verify the license terms first—the metadata does not specify one—and ensure your LLM API and Python 3.12+ environment are in place before starting.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later; an LLM API key and model configuration are needed to instantiate agents.
- Active maintenance with a release 2 days old and 987 repository stars.
- Low install friction with a pure-Python wheel and only 3 runtime dependencies.
License · maintenance · safety
(unclear) — License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in commercial or proprietary projects.
last release 2026-08-12 (2 days) · last repo commit 2026-08-14 · 987 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 739,540 downloads/mo, #5,185 on PyPI
Alternatives
Verify before relying
pip install openhands-workspace
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.terminal import TerminalTool
llm = LLM(model="gpt-5.5", 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 unclear license permits commercial use or requires attribution.
- Whether openhands-agent-server must be separately installed or deployed for remote workspace execution.
- Performance characteristics and latency when running agents in ephemeral containers.
What it is and what it does
OpenHands Workspace is a Python SDK for building autonomous software agents that can read, write, and execute code. It wraps an LLM with a set of tools—file editor, terminal, task tracker—and manages a workspace where the agent can operate. Agents can run locally on your machine or inside ephemeral containers (Docker, Kubernetes) via the Agent Server, making it suitable for one-off tasks like README generation, routine maintenance like dependency updates, or larger refactors involving multiple coordinated agents.
The SDK is the foundation for the OpenHands CLI and OpenHands Cloud. It depends on openhands-sdk (core agent logic), openhands-agent-server (remote execution), and pydantic (data validation). The package is actively maintained, has low install friction, and supports modern Python versions (3.12+). No known security vulnerabilities are recorded.
Use it for
- Generate or update documentation automatically by having an agent read your codebase and write a README.
- Automate routine maintenance tasks like updating dependencies or running linters across a repository.
- Orchestrate multi-agent refactoring or rewriting tasks that require coordinated code changes.
- Build custom developer tools or CI/CD workflows that delegate code tasks to autonomous agents.
- Integrate LLM-powered code assistance into your own applications via the REST API.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to build LLM-powered agents that can work with code.
The package is actively maintained, has low install friction, and a clear use case. However, verify the license terms first—the metadata does not specify one—and ensure your LLM API and Python 3.12+ environment are in place before starting.
Install
openhands-workspace on PyPI
Before you install
Active maintenance with a release 2 days old and 987 repository stars. Low install friction with a pure-Python wheel and only 3 runtime dependencies. Requires Python 3.12 or later.
Requires Python 3.12 or later; an LLM API key and model configuration are needed to instantiate agents.
License in practice
License treatment is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in commercial or proprietary projects.
Quickstart
pip install openhands-workspace
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.tools.terminal import TerminalTool
llm = LLM(model="gpt-5.5", 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 unclear license permits commercial use or requires attribution.
- Whether openhands-agent-server must be separately installed or deployed for remote workspace execution.
- Performance characteristics and latency when running agents in ephemeral containers.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesopenhands-sdkopenhands-agent-serverpydantic |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 739,540 / month, #5,185 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: openhands_workspace-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 › “llm-powered software agents”
- openhands-workspaceProvides Python and REST APIs for building software agents that can…
- openhands-toolsProvides Python and REST APIs for building AI agents that work with…
- tom-sweAdds Theory of Mind capabilities to software engineering agents,…
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-agent-server · openhands-sdk · openhands-tools · openhands-ai · openhands-aci · openhands · cursor-sdk · openai-codex · alita-sdk · plato-sdk-v2