openhands-agent-server
OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent
Decision gist · record as of 2026-08-14
Yes, if you need a production-ready agent server for code automation. The package is actively maintained, has low install friction, and sits in the top 5000 PyPI packages by download volume. The main caveat is the unclear license—verify it matches your use case before committing. Requires Python 3.12 or later.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later.
- Docker is a runtime dependency if you plan to use containerized workspaces.
- Low friction: pure Python wheel with 11 runtime dependencies including fastapi, sqlalchemy, and docker.
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) · 1,416,943 downloads/mo, #3,931 on PyPI
Alternatives
Verify before relying
pip install openhands-agent-server
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 the current directory")
conversation.run()- Whether the package can be used standalone or requires additional OpenHands components to function
- Specific LLM models and API providers supported beyond the example
- Performance characteristics and scalability limits for concurrent agent sessions
- Whether public skills marketplace requires network access or authentication
What it is and what it does
OpenHands Agent Server is a Python package that exposes AI agents capable of working with code through REST and WebSocket APIs. It builds on the openhands-sdk to let you run agents remotely, either on the local machine or in ephemeral Docker/Kubernetes workspaces. The server handles agent lifecycle, tool execution (file editing, terminal commands, task tracking), and workspace management.
You use it to automate code-related tasks—writing documentation, updating dependencies, refactoring—by sending natural-language instructions to an agent that can read files, run commands, and track progress. The package includes fastapi for the HTTP layer, sqlalchemy for state persistence, and integrates with openai for LLM inference. It's designed both as a standalone service and as the backbone for higher-level tools like the OpenHands CLI and Cloud platform.
Use it for
- Run an AI agent as a remote service to handle one-off code tasks like generating README files or documentation
- Automate routine maintenance workflows such as dependency updates across multiple repositories
- Execute complex multi-agent refactoring or rewrite tasks in isolated, ephemeral Docker containers
- Build custom developer tools or CI/CD integrations that delegate code work to AI agents via REST
- Deploy agents in Kubernetes for scalable, on-demand code automation in production environments
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a production-ready agent server for code automation.
The package is actively maintained, has low install friction, and sits in the top 5000 PyPI packages by download volume. The main caveat is the unclear license—verify it matches your use case before committing. Requires Python 3.12 or later.
Install
openhands-agent-server on PyPI
Before you install
Low friction: pure Python wheel with 11 runtime dependencies including fastapi, sqlalchemy, and docker. Active maintenance with a release 2 days old and recent commits. Requires Python 3.12 or later.
Requires Python 3.12 or later. Docker is a runtime dependency if you plan to use containerized workspaces.
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-agent-server
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 the current directory")
conversation.run()Verify before relying
- Whether the package can be used standalone or requires additional OpenHands components to function
- Specific LLM models and API providers supported beyond the example
- Performance characteristics and scalability limits for concurrent agent sessions
- Whether public skills marketplace requires network access or authentication
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 11 packagesaiosqlitealembicdockerfastapiopenhands-sdkopenaipydanticsqlalchemyuvicornwebsocketswsproto |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,416,943 / month, #3,931 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: openhands_agent_server-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 server for code tasks”
- openhands-agent-serverProvides a REST and WebSocket API server for running OpenHands AI…
- openhands-workspaceProvides Python and REST APIs for building software agents that can…
- openhands-sdkOpenHands SDK provides Python and REST APIs for building software…
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 · openhands-ai · openhands-workspace · openhands-aci · openhands-sdk · openhands-tools · openviking · azure-ai-agentserver-invocations · deepagents-cli · agent-framework-devui