OpenHands

# Local secrets — never commit the real .env
.env
# ...but keep the committed template (root .gitignore's `.env.*` would hide it).
!.env.sample

"""OpenHands: an autonomous coding agent on the OpenHands Agent SDK.

OpenHands runs a real read–edit–run loop. This sample uses the SDK's *local*
workspace, so the agent runs its terminal + file-edit tools in this container —
no nested Docker sandbox — which keeps it to a single headless run.

The model is routed through LiteLLM via LLM_MODEL, so the same code works with
Anthropic Claude, OpenAI, or any LiteLLM-supported provider.

Run:
    docker build -t aas-openhands .
    docker run --rm --env-file .env aas-openhands \
        "Create result.txt with the result of 2 + 2, then read it back."
"""

import os
import sys

from openhands.sdk import LLM, Conversation
from openhands.tools.preset.default import get_default_agent
from pydantic import SecretStr

DEFAULT_TASK = (
    "Create result.txt containing the result of 2 + 2, then read it back "
    "and tell me the value."
)


def main() -> None:
    task = " ".join(sys.argv[1:]) or DEFAULT_TASK

    llm = LLM(
        usage_id="agent",
        model=os.environ.get("LLM_MODEL", "anthropic/claude-opus-4-8"),
        api_key=SecretStr(os.environ.get("LLM_API_KEY", "")),
        # claude-opus-4-8 uses a newer thinking API than this OpenHands/LiteLLM
        # build emits, so disable extended thinking to stay compatible.
        reasoning_effort=None,
    )

    # cli_mode=True keeps the terminal + file-editor tools and drops the browser.
    agent = get_default_agent(llm=llm, cli_mode=True)

    # A local workspace runs actions in this container — no nested Docker sandbox.
    workspace = os.environ.get("WORKSPACE", "/workspace")
    conversation = Conversation(agent=agent, workspace=workspace)
    conversation.send_message(task)
    conversation.run()


if __name__ == "__main__":
    main()

# Image for the OpenHands sample. OpenHands pulls a large dependency set
# (playwright, jupyter, …), so this image is several GB — expect a slow first build.
FROM python:3.12-slim

# Stream stdout/stderr unbuffered so the agent's steps appear live.
ENV PYTHONUNBUFFERED=1

# Hide the SDK's import-time startup banner so the agent's output stays clean.
ENV OPENHANDS_SUPPRESS_BANNER=1

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY app.py .

# The agent works here — a local workspace, not a nested Docker sandbox.
RUN mkdir -p /workspace
ENV WORKSPACE=/workspace

# Provide your config at run time (.env is NOT baked into the image):
#   docker run --rm --env-file .env aas-openhands "<task>"
ENTRYPOINT ["python", "app.py"]

openhands-ai>=1.6,<2