Getting StartedQuick Start

Quick Start

Get HeySummon running in 5 minutes.

Option 1: Use the Cloud Version

The easiest way to get started — no setup required.

  1. Go to cloud.heysummon.ai
  2. Sign in with GitHub or Google
  3. Go to Settings → create an API key
  4. Give the API key to your AI agent

Option 2: Self-Host

git clone https://github.com/thomasansems/hitlaas-platform.git
cd hitlaas-platform
npm install
cp .env.example .env.local  # edit with your credentials
npx prisma generate && npx prisma db push
npx prisma db seed  # optional: creates test user + sample data
npm run dev

Open http://localhost:3000.

Option 3: Docker

git clone https://github.com/thomasansems/hitlaas-platform.git
cd hitlaas-platform
bash scripts/setup.sh

The setup wizard handles connectivity (Cloudflare Tunnel, Tailscale Funnel, or Ngrok) and generates your .env automatically.

See Self-Hosting Guide for details.

Test the API

# 1. Generate RSA key pair
openssl genpkey -algorithm RSA -out private.pem -pkeyopt rsa_keygen_bits:2048
openssl rsa -in private.pem -pubout -out public.pem
 
# 2. Submit a help request
curl -X POST https://cloud.heysummon.ai/api/v1/help \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "hs_your_key",
    "publicKey": "'"$(cat public.pem)"'",
    "messages": [{"role":"user","content":"Test"}],
    "question": "Is this working?"
  }'
 
# 3. Poll for response
curl https://cloud.heysummon.ai/api/v1/help/REQUEST_ID

Next Steps

IntroductionSkills Quickstart