AI layer for WokSpec. Ships as a Cloudflare Worker API, an embeddable widget, and a browser extension.

Live: eral.wokspec.org · Source available: FSL-1.1-MIT

Eral is the AI backbone across every WokSpec product. The same model and memory layer powers the chat widget on wokspec.org, the AI companion in WokGen and Vecto, the news analysis in WokPost, and the browser extension.

apps/
  api/        # Cloudflare Worker — Hono, chat/generate/analyze endpoints
  extension/  # Browser extension — Plasmo, works in Chrome/Firefox/Edge
  widget/     # Embeddable React widget — drop into any page

All endpoints require Authorization: Bearer <jwt> (WokSpec JWT, shared secret).

Every main Eral endpoint now accepts optional integration metadata so external apps can tell Eral where it is running and what the user is doing.

{
  "product": "support-portal",
  "integration": {
    "name": "Acme Support Dashboard",
    "kind": "webapp",
    "url": "https://support.example.com/tickets/42",
    "pageTitle": "Ticket #42",
    "capabilities": ["chat", "generate", "page-context"],
    "instructions": "Prefer concise support-agent answers."
  }
}

Main generation endpoints also accept optional quality: "fast" | "balanced" | "best" so callers can trade off latency versus output quality while still respecting Eral's spend policy.

By default Eral runs in free-only mode so it stays on Cloudflare Workers AI even if an OPENAI_API_KEY is present. You can switch to paid-fallback or paid-primary explicitly if you want OpenAI available.

The default model is @cf/meta/llama-3.3-70b-instruct-fp8-fast, with @cf/meta/llama-3.1-8b-instruct-fp8-fast as the automatic fallback. You can also override models per route with CF_AI_CHAT_MODEL, CF_AI_GENERATE_MODEL, CF_AI_ANALYZE_MODEL, CF_AI_WOKGEN_MODEL, and the matching OPENAI_* variants.

Eral Web Extension — available for Chrome, Firefox, and Edge (Plasmo-based).

Built from apps/extension/. The extension:

• Adds Eral to any webpage via a floating panel
• Clips selected text to Eral memory
• Runs research and meeting modes (in development)

cd apps/extension
npm install
npm run dev     # dev mode — loads unpacked in browser
npm run build   # production build

Drop the Eral widget into any WokSpec product (or external site):

<script
  src="https://eral.wokspec.org/widget.js"
  data-eral-key="eral_..."
  data-eral-name="Eral"
  data-eral-product="support-portal"
  data-eral-quality="best"
  data-eral-page-context="true"
></script>

The widget now runs inside a Shadow DOM, exposes window.EralWidget, and keeps window.Eral as a compatibility alias.

cd apps/api
npm install
npm run dev       # wrangler dev on :8788
npm run deploy    # deploy to Cloudflare Workers

wrangler secret put JWT_SECRET       # must match WokAPI
wrangler secret put OPENAI_API_KEY   # optional — GPT-4o

wrangler kv namespace create KV_MEMORY
# add the id to wrangler.toml

Source available under FSL-1.1-MIT. Free for personal and non-commercial use. Converts to MIT two years after publication.