OpenHands Core¶
OpenHands Core is an Ubuntu 24.04 AMI that runs the OpenHands Agent Canvas on your own EC2 instance. You open it in your browser through a private tunnel, connect your own cloud model provider, and let the agent work on your projects with Python, terminal and Git tools. An optional private Telegram bridge lets you send tasks from a dedicated bot.
Launch on AWS Marketplace Getting started
What is included¶
| Component | Details |
|---|---|
| Operating system | Ubuntu 24.04 LTS, x86_64, CPU only |
| OpenHands | Agent Canvas 1.24.0 with Agent Server 1.50.1 and Automation 1.17.0 |
| Tools | Python terminal, Git, persistent projects and conversations |
| Runtime | A pre-built container, started automatically by the sushi-openhands service |
| Telegram bridge | Optional, installed but turned off. Maintained by Software Sushi, not native OpenHands Telegram support. |
OpenHands Core does not include bundled ACP command-line agents, browser binaries or the code editor. No model, model credits or GPU are included: you bring your own cloud model provider and key.
Ports¶
| Port | Purpose | Exposure |
|---|---|---|
| 8000/tcp | Agent Canvas web UI and API | Bound to 127.0.0.1 only. Reach it through an SSH or Session Manager tunnel. |
| 22/tcp | SSH, optional | Restrict it to your administrator CIDR. |
Do not open port 8000 in your security group.
Recommended instance¶
t3.medium(2 vCPU, 4 GiB RAM) or larger. At least 4 GiB RAM.- At least 32 GiB gp3 root volume, encrypted if your policies require it.
- IMDSv2, and outbound HTTPS to your model provider and, if you use it, Telegram.
Billing¶
You pay an hourly software fee for each running instance, shown on the AWS Marketplace listing. An optional five-day free trial covers the software fee for one instance and then converts to hourly billing. It is the same software before and after the trial. EC2, EBS, data transfer and your model provider's charges are billed separately, including during the trial.
Where to go next¶
- Getting started: launch, open the UI, connect a model and run a first task.
- Configuration: models, projects and the Telegram bridge.
- Operations: security model, backups, upgrades and support.
- Troubleshooting: common problems and fixes.
Upstream project¶
OpenHands is open-source software under the MIT license. Software Sushi packages it and is not affiliated with or endorsed by the OpenHands project.