Installation

You have three ways to get the SDK on your site. Pick whichever fits your stack.

Via npm / pnpm / yarn

npm install @bitpalm/ai-agents
# or
pnpm add @bitpalm/ai-agents
# or
yarn add @bitpalm/ai-agents

Use this if you have a build pipeline (React, Next.js, Vite, Webpack). Continue to Quickstart React or Quickstart Vanilla.

Via script tag (no build step)

<script
  async
  src="https://unpkg.com/@bitpalm/ai-agents"
  data-slug="your-agent-slug"
  data-token="your-embed-token"
></script>

Use this on Webflow, WordPress, Shopify themes, or any plain HTML page. Continue to Quickstart Script Tag.

Get your agent slug and token

Both come from your BitPalm dashboard:

1. Sign in (or create a free account)
2. Open your agent → Settings → Embed
3. Copy the slug and (if your agent is restricted) the token

Public vs. private agents. Public agents only need the slug. Private (token-restricted) agents need both. Set this in dashboard → Access.