Přeskočit na obsah

Řešení · Programovací agenti

VPS pro OpenHands

OpenHands je autonomní programovací agent: zadáte mu repozitář a úkol a on sám upravuje, spouští, testuje a otevírá pull requesty, s modelem dle vaší volby za API klíčem. Jeho vlastní README říká, že nejvýkonnější způsob provozu je na serveru v cloudu, a jeho vlastní varování říká, že agent má plný přístup ke stroji, na kterém běží. Obojí vede ke stejné odpovědi: stroj, který není ničím notebookem. Serverový návod projektu označuje 2 vCPU a 4 GB za dostatečné pro jednoho uživatele; BD-8 za $12.90 měsíčně nabízí dvojnásobek za méně než stroje se 4 GB jinde.

Co potřebuje

Software podle dokumentace, velikosti s uvedeným zdrojem

Software a bezpečnostní nastavení vycházejí z vlastní dokumentace projektu. Kde projekt neuvádí žádné hardwarové údaje, velikosti uvádějí, odkud pocházejí.

Z README, SELF_HOSTING.md a dokumentace OpenHands

  • „2 vCPU / 4 GB RAM na jednoho uživatele bohatě stačí“ (návod projektu k VM). Dokumentace požaduje „moderní procesor a minimálně 4GB RAM“.
  • Instalace: Node.js 24 nebo novější a uv, poté npx @openhands/agent-canvas --public. Jeden příkaz spustí server agenta, automatizační backend a webovou aplikaci za ingressem na 127.0.0.1:8000.
  • Nastavte LOCAL_BACKEND_API_KEY před prvním spuštěním: ve veřejném režimu jej musí nést každé volání API a webová aplikace si o něj řekne před čímkoli jiným. Nejdřív zablokujte firewallem vše kromě SSH; návod říká, že to máte udělat dříve, než agent vůbec poběží.
  • API klíč od poskytovatele modelu: dokumentace uvádí, že jej OpenHands potřebuje pro většinu modelů. Docker je volitelný a je potřeba jen tehdy, pokud chcete mít každou konverzaci izolovanou ve vlastním kontejneru. GPU není potřeba, pokud model nehostujete sami.

Velikosti (hodnota projektu, poté naše)

Dimenzování podle použití
ZátěžvCPURAM
Jeden uživatel, hostované modely, agent na hostiteli (oficiální)Vlastní hodnota z návodu. Server agenta běží přímo na stroji, takže sandboxem je samotný stroj.24 GB
Jeden nebo dva uživatelé, Docker sandbox pro každou konverzaciNaše. Každá konverzace dostane kontejner; instalace závislostí, sestavení a testovací sady běží uvnitř.48 GB
Sdílený týmový server agentů, více agentů najednouNaše. Paralelní agenti na paralelních repozitářích, každý něco kompiluje.824 GB

Vhodné tarify

5 počítačů s aktuálními cenami

Nejlevnější vyhovující stroj první. Ceny jsou dnešní, měsíční, načtené z katalogu.

  • BD-8$12.90/měs.

    4 vCPU · 8 GB · 100 GB disk · 32 TB

    Nejlevnější s prostorem pro sestavování a testy. 4 vCPU, 8 GB, 100 GB a 32 TB přenosu, za méně než stroje se 4 GB jinde. Dvojnásobek hodnoty z návodu; testovací sady jádra poznají.

  • U2-4-40$14.90/měs.

    2 vCPU · 4 GB · 40 GB disk · Unmetered

    Přesně hodnota z návodu, neměřený provoz, Istanbul. 2 vCPU / 4 GB / 40 GB. Jeden uživatel, hostované modely, agent přímo na hostiteli. Neměřený přenos pro klonování a instalace balíčků.

  • BD-24$31.90/měs.

    8 vCPU · 24 GB · 300 GB disk · 32 TB

    8 vCPU / 24 GB pro týmový server agentů. Více agentů najednou, Docker sandboxy, automatizační backend podle plánu.

  • C2-4-80$37.90/měs.

    2 vCPU · 4 GB · 80 GB disk · 3 TB

    Hodnota z návodu v desítkách měst. 2 vCPU / 4 GB / 80 GB. Zvolte jej kvůli městu; provozujte jednu konverzaci najednou.

  • C4-8-160$75.90/měs.

    4 vCPU · 8 GB · 160 GB disk · 3 TB

    4 vCPU / 8 GB / 160 GB, v desítkách měst. Pohodlná velikost s diskem pro mnoho checkoutů a Docker image.

Startovací předvolba pro OpenHands zatím neexistuje: instalace je pět níže uvedených kroků, které napíšete sami, v pořadí, jaké uvádí vlastní návod projektu. Nejdřív firewall, pak klíč, nakonec agent.

Instalace

Pět kroků v pořadí, které uvádí vlastní návod OpenHands

Návod výslovně říká, že firewall má přijít před prvním spuštěním, protože server agenta má ke stroji volný přístup a mezi ním a cizím člověkem stojí jen firewall a klíč.

  1. Nejdřív firewall. ufw allow OpenSSH && ufw --force enable Žádný příchozí provoz kromě SSH. Ingress (8000), server agenta (18000), automatizační backend (18001) a statický server (3001) nesmí být dostupné zvenčí; návod to říká přesně těmito slovy.
  2. Node.js 24 a uv. apt-get install -y curl git curl -fsSL https://deb.nodesource.com/setup_24.x | bash - && apt-get install -y nodejs curl -LsSf https://astral.sh/uv/install.sh | sh uv spouští server agenta; návod jej instaluje jednořádkovým instalátorem z astral.sh.
  3. Vygenerujte klíč, spusťte ve veřejném režimu. export LOCAL_BACKEND_API_KEY=$(openssl rand -base64 32); echo $LOCAL_BACKEND_API_KEY npx @openhands/agent-canvas --public Než budete pokračovat, zkopírujte klíč na bezpečné místo; veřejný režim znamená, že si o něj webová aplikace řekne. Pro dlouhodobý provoz použijte jednotku systemd z návodu v /etc/systemd/system/agent-canvas.service s Environment=LOCAL_BACKEND_API_KEY=… a poté systemctl enable --now agent-canvas.
  4. Připojte se přes SSH, přidejte model. ssh -N -L 8000:127.0.0.1:8000 root@your-server poté http://127.0.0.1:8000, vložte klíč a v Settings zvolte poskytovatele LLM a model a vložte API klíč tohoto poskytovatele. Zahajte konverzaci nad repozitářem.
  5. Volitelně doména. Nasměrujte záznam A na server, otevřete porty 80 a 443, apt-get install -y nginx certbot python3-certbot-nginx a použijte blok nginx z návodu, který přeposílá na 127.0.0.1:8000 s hlavičkami WebSocket; certbot --nginx -d canvas.example.com --redirect získá certifikát. Pokud musí být port 443 otevřený do světa, návod říká, že klíč je vaší hlavní obranou, proto jej mějte dlouhý a tajný.

Upřímně

Co bychom skutečně koupili

Návod říká, že 2 vCPU a 4 GB stačí pro jednoho uživatele. Kupte stroj s 8 GB, který stojí méně než ty se 4 GB, a nechte agenta kompilovat.

Pro programovacího agenta jednoho člověka

BD-8 · $12.90/měs.

4 vCPU, 8 GB a 100 GB za $12.90: server agenta, několik checkoutovaných repozitářů, jejich stromy závislostí a testovací sada běžící, zatímco se díváte, a ještě zbývá paměť, pokud zapnete Docker sandboxy. Model je jinde, za API klíčem, takže tento stroj nikdy nepotřebuje GPU a podstatný účet je ten od poskytovatele. C2-4-80 za $37.90 je přesná hodnota z návodu v desítkách měst, pokud je pro vás město důležitější než jádra.

Otázky

Na co se lidé ptají před koupí.

Kolik RAM OpenHands potřebuje?
Vlastní návod projektu pro VM uvádí, že 2 vCPU a 4 GB RAM stačí pro jednoho uživatele, a dokumentace doporučuje moderní procesor a minimálně 4 GB. To pokrývá server agenta, automatizační backend a webovou aplikaci s hostovanými modely. To, co agent poté dělá, tedy klonování repozitářů, instalace závislostí, sestavení a testy, je běžná vývojářská práce a vyžaduje běžné vývojářské prostředky, a proto má nejlevnější stroj na této stránce 4 jádra a 8 GB, nikoli přesné minimum.
Proč jej provozovat na serveru místo na notebooku?
Dva důvody přímo z README. Říká, že nejvýkonnější způsob provozu OpenHands je na serveru v cloudu, takže agenti běží dál, i když je notebook zavřený, a lze je spouštět ze Slacku, GitHubu nebo webhookem. A varuje, že server agenta běží přímo na stroji s plným přístupem k souborovému systému, shellu a síti. Stroj, na kterém není nic než agent a repozitáře, se kterými pracuje, je poctivý způsob, jak mu tento přístup dát.
Potřebuje API klíč, nebo může použít lokální model?
Dokumentace uvádí, že OpenHands vyžaduje API klíč pro přístup k většině jazykových modelů, a uvádí doporučené hostované poskytovatele. Lokální model přes Ollama nebo podobný server je podporován, dokumentace však dodává, že efektivní práce agenta s lokálními modely vyžaduje výkonný hardware a modely vyladěné na plnění instrukcí. V praxi: hostovaný model a API klíč na tomto stroji, a pokud chcete lokální model, samostatný server pro model dimenzovaný podle stránky Ollama nebo řady GPU.
Co dělají --public a LOCAL_BACKEND_API_KEY?
Bez --public aplikace pro pohodlí vkládá svůj klíč relace do webové stránky, což README označuje za nebezpečné u veřejně dostupného nasazení. S --public klíč na stránce není: každý, kdo otevře webovou aplikaci, musí nejprve vložit LOCAL_BACKEND_API_KEY a musí jej nést každé volání API. Pořadí podle návodu je firewall, pak klíč, pak spuštění, a klíč generuje příkazem openssl rand -base64 32.
Potřebuji Docker?
Pro výchozí instalaci ne, ta spouští server agenta přímo na hostiteli s Node 24 a uv. Docker slouží pro izolované režimy: spuštění celého stacku z image projektu, nebo přidělení vlastního kontejneru každé konverzaci, aby mohlo pracovat více agentů najednou bez sdíleného souborového systému. README upozorňuje, že sandbox izoluje provádění konverzací, nikoli celou aplikaci. Pokud jej chcete, nainstalujte Docker a počítejte s řádkem 8 GB nebo vyšším.
Které porty se používají?
Vše naslouchá na loopbacku: ingress proxy na 127.0.0.1:8000 směruje na statický server na portu 3001, server agenta na 18000 a automatizační backend na 18001. Na port 8000 se dostanete přes SSH tunel, nebo přes nginx na 443, pokud přidáte doménu. Žádný z těchto čtyř portů by neměl být na firewallu otevřený; návod je uvádí čísly jako porty, které nesmí být dostupné zvenčí.