OpenHands AI Action

A GitHub Action that enables AI-powered task automation using headless mode of OpenHands. Execute complex tasks using natural language prompts in your GitHub workflows.

Find it on Github Actions Marketplace: xinbenlv/openhands-ai-action

Features

• Execute AI-powered tasks using natural language prompts
• Customizable LLM models (default: Claude 3 Sonnet)
• Configurable runtime environment
• Detailed logging and output capture
• Support for additional environment variables
• Docker-based execution with secure sandboxing

Usage

name: Run OpenHands Task
on: [push, pull_request]

jobs:
  run-openhands:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Execute OpenHands Task
        uses: xinbenlv/openhands-action@v1.0.1-rc3
        with:
          prompt: "Your natural language task description here"
          llm_api_key: ${{ secrets.LLM_API_KEY }}
          # Optional parameters
          llm_model: "anthropic/claude-3-7-sonnet-20250219"
          log_all_events: "true"

          additional_env: |
            {
              "CUSTOM_VAR": "value",
              "ANOTHER_VAR": "another_value"
            }

Inputs

Input	Required	Description	Default
prompt	Yes	The natural language prompt or task to execute	-
llm_api_key	Yes	API key for the LLM service (e.g., Anthropic API key)	-
llm_model	No	The LLM model to use	anthropic/claude-3-7-sonnet-20250219
log_all_events	No	Enable detailed logging of all events during task execution	true
runtime_image	No	Docker image for the runtime environment	docker.all-hands.dev/all-hands-ai/runtime:0.32-nikolaik
openhands_image	No	Docker image for the OpenHands AI service	docker.all-hands.dev/all-hands-ai/openhands:0.32
additional_env	No	JSON string of additional environment variables to pass to the container	{}

Environment Variables

The action supports passing additional environment variables through the additional_env input. These variables will be available in the container during task execution. Example:

{
  "CUSTOM_VAR": "value",
  "ANOTHER_VAR": "another_value"
}

Security

• The action uses Docker for secure sandboxing of task execution
• API keys and sensitive information should be stored in GitHub Secrets
• The runtime environment is isolated from the host system

License

MIT License

Support

For support, please open an issue in the GitHub repository.