{"library":"openhands-agent-server","title":"OpenHands Agent Server","description":"OpenHands Agent Server is the server-side component for OpenHands AI agents, providing RESTful and WebSocket APIs for agent interaction and management. It serves as the backbone for running and communicating with AI agents developed using the OpenHands Software Agent SDK. Currently at version 1.16.1, the library maintains an active development pace with minor versions released frequently.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install openhands-agent-server"],"cli":null},"imports":["from openhands_agent_server.config import AppConfig","from openhands_agent_server.main import app"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import uvicorn\nimport os\n\n# Set any necessary environment variables for configuration (e.g., API keys)\n# For example, to configure an OpenAI key (replace with your actual key/method)\n# os.environ['OPENAI_API_KEY'] = os.environ.get('OPENAI_API_KEY', 'your-openai-api-key')\n\nif __name__ == \"__main__\":\n    # The server's main FastAPI application instance is named 'app' in 'openhands_agent_server.main'\n    print(\"Starting OpenHands Agent Server on http://0.0.0.0:8000\")\n    uvicorn.run(\"openhands_agent_server.main:app\", host=\"0.0.0.0\", port=8000, reload=True)","lang":"python","description":"This quickstart demonstrates how to programmatically start the OpenHands Agent Server using `uvicorn`. This is useful for embedding the server within a larger Python application or for custom deployment configurations. The server will be accessible at `http://0.0.0.0:8000`.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"1.22.1","pypi_latest":"1.22.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":40,"avg_install_s":34,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.4,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.5,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"openhands-agent-server","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"373.7M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"openhands-agent-server","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":38.7,"import_time_s":null,"mem_mb":null,"disk_size":"352M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"openhands-agent-server","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"373.4M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"openhands-agent-server","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":29.2,"import_time_s":null,"mem_mb":null,"disk_size":"351M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"openhands-agent-server","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.7,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}