Skip to main content

Quick Start

This guide helps you get started with OpenHuman in 5 minutes.

Step 1: Install​

Choose an installation method based on your operating system:

# macOS
brew install --cask openhuman

# Windows
winget install OpenHuman

# Linux
sudo snap install openhuman

Or use npm:

npm install -g openhuman-sdk

Step 2: Launch the App​

After installation, run:

openhuman

Or launch the Mascot desktop app.

Step 3: Configure API Key​

On first use, set up your API key:

  1. Get your key from console.tinyhumans.ai
  2. Enter the key in the app settings
  3. Or set an environment variable:
export OPENHUMAN_API_KEY=sk_xxx

Step 4: Chat with the Agent​

Now you can start chatting with the agent:

You: Hello, please introduce yourself
Agent: Hello! I'm OpenHuman, an AI Agent...

Step 5: Explore Features​

Memory​

The agent can remember things you tell it:

You: My name is John
Agent: Okay, John. I've noted that.

Tool Use​

The agent can help you execute tasks:

You: Search for the latest AI news
Agent: [Searching...]

Integrations​

Connect your calendar, email, and more:

  1. Go to Skills → Integrations
  2. Select Gmail or another service
  3. Complete OAuth authorization

Next Steps​