CoreThink.ai Docs home pagelight logo
  1. CLI Tools
  2. OpenHands CLI

​
Prerequisites

Before you begin, make sure you have:

  • Python 3.8 or higher installed
  • Git installed and configured
  • A CoreThink account with an active API key
  • Terminal/command line familiarity

​
Step 1: Install OpenHands CLI

Install OpenHands using pip (Python package manager):

pip install openhands

Alternative: Install with development dependencies:

pip install openhands[all]

​
Step 2: Verify Installation

Confirm that OpenHands is properly installed:

openhands --version
openhands --help

​
Step 3: Get Your CoreThink API Key

  1. Go to CoreThink Dashboard
  2. Sign in to your account
  3. Navigate to your Dashboard
  4. Create an API Key (copy it immediately - you won’t see it again)
  5. Create an organization if you don’t have one

​
Step 4: Configure API Credentials

Option 1: Environment Variables

export OPENAI_API_KEY="your-corethink-api-key"
export OPENAI_API_BASE="https://api.corethink.ai/v1/code"
export OPENHANDS_MODEL="corethink"

Option 2: Configuration File

Create ~/.openhands/config.yml:

model: corethink
api_key: your-corethink-api-key
api_base: https://api.corethink.ai/v1/code
max_tokens: 8000
temperature: 0.1

​
Step 5: Initialize Project Directory

Prepare your project directory:

cd your-project-folder
git init
git config user.name "Your Name"
git config user.email "your-email@example.com"

​
Step 6: Start OpenHands Agent

Launch OpenHands and start using CoreThink AI:

# Start OpenHands in interactive mode
openhands

# Or start with specific task
openhands "Implement a REST API for user management"

# Or start in sandboxed mode
openhands --model corethink --sandbox

​
Troubleshooting

​
Connection Issues

  • Verify your API key is correct and active
  • Ensure you’re using the correct endpoint: https://api.corethink.ai/v1/code
  • Check your internet connection
  • Verify environment variables are set correctly: echo $OPENAI_API_KEY

​
Installation Errors

  • Ensure Python 3.8+ is installed: python3 --version
  • Try upgrading pip: pip install --upgrade pip
  • Use a virtual environment: python3 -m venv venv && source venv/bin/activate

​
Git Errors

  • Ensure Git is installed: git --version
  • Initialize Git repository in your project directory
  • Configure Git user name and email

​
API Key Errors

  • Generate a new API key from here
  • Ensure your organization has available credits
  • Verify configuration file or environment variables are set correctly

​
Next Steps