Embed script

The embed script is the enterprise SKU’s deployment surface. Add one tag to your site; every visitor gets the agent without installing anything.

Install

Drop this into your site’s <head>:

<script
  src="https://cdn.wholisphere.ai/embed.js"
  data-key="org_yourkey"
  data-backend="https://api.wholisphere.ai"
  data-position="bottom-right"
  data-wholisphere
></script>

Get your org_yourkey from the dashboard.

Configuration attributes

Attribute	Required	Default	Description
`data-key`	yes	—	Your organization key
`data-backend`	no	`https://api.wholisphere.ai`	API URL
`data-position`	no	`bottom-right`	One of `bottom-right`, `bottom-left`, `top-right`, `top-left`
`data-shortcut`	no	`ctrl+alt+a`	Hotkey to toggle the panel
`data-full-agent`	no	`true`	Set `false` to load only local capabilities
`data-wholisphere`	yes	—	Marker attribute so we can find the host script

Programmatic API

The script exposes window.Wholisphere:

Wholisphere.open();    // open the panel
Wholisphere.close();   // close it
Wholisphere.version;   // string

Useful if you want your own “Accessibility tools” link to invoke the panel.

What the visitor gets

Modality	Capabilities
Vision	Read aloud, high contrast, larger text
Cognitive	Simplify text, summarize page

(Describe-image and voice-click are deferred to v2 on the embed because they need permission flows that are safer in the extension.)

Keep the agent fresh

When you deploy, run our GitHub Action to invalidate the cached intent. Otherwise stale cache will mean stale action plans for visitors after a deploy.

Performance

The bundle is ~29 KB gzipped and lazy-loads after first paint. Real-world LCP impact under 50 ms.

Coexistence with native AT

The widget is role="complementary" — JAWS / NVDA / VoiceOver users find it via standard landmark navigation. They can ignore it and continue with their AT, or engage selectively.

CSP

Add to your Content-Security-Policy:

script-src 'self' https://cdn.wholisphere.ai;
connect-src 'self' https://api.wholisphere.ai;