probot-self-hosted

Self-hosted ProBot chatbot as an npm package. Install it in your web app, configure your bot in code, and render <ProbotBot /> - no separate runtime to clone or deploy. Optionally link the widget to your ProBot dashboard for conversation and lead analytics (dashboard is view-only for self-hosted bots).

npm i probot-self-hosted

Quick example (React / Next.js)

"use client";

import { ProbotBot } from "probot-self-hosted";

export function ChatWidget() {
  return (
    <ProbotBot
      name="Ada"
      headline="Ask me about my work"
      personality="professional"
      themeColor="#2563eb"
      context={`I'm Ada Lovelace, a mathematician…`}
      suggestedQuestions={["What projects are you working on?"]}
      captureLead
      sendMessage={async ({ system, messages }) => {
        const res = await fetch("/api/probot-chat", {
          method: "POST",
          headers: { "content-type": "application/json" },
          body: JSON.stringify({ system, messages }),
        });
        const data = await res.json();
        return data.reply;
      }}
      dashboard={{ token: process.env.NEXT_PUBLIC_PROBOT_TOKEN! }}
    />
  );
}

Then in a Next.js Route Handler (server-only):

// app/api/probot-chat/route.ts
import { createOpenAIHandler } from "probot-self-hosted/adapters/openai";

const send = createOpenAIHandler({
  baseUrl: "https://api.openai.com/v1",
  apiKey: process.env.OPENAI_API_KEY!,
  model: "gpt-4o-mini",
});

export async function POST(req: Request) {
  const { system, messages } = await req.json();
  const reply = await send({ system, messages });
  return Response.json({ reply });
}

Vanilla HTML (script tag)

<div id="probot"></div>
<script src="https://unpkg.com/probot-self-hosted/dist/probot-self-hosted.iife.js"></script>
<script>
  ProbotSelfHosted.mount("#probot", {
    name: "Ada",
    context: "…",
    sendMessage: async ({ system, messages }) => {
      const res = await fetch("/api/probot-chat", {
        method: "POST",
        headers: { "content-type": "application/json" },
        body: JSON.stringify({ system, messages }),
      });
      return (await res.json()).reply;
    },
  });
</script>

Dashboard analytics

Register a self-hosted bot in the ProBot dashboard, mint a token from Settings → Deployment, and pass it as dashboard.token. Every completed turn and captured lead is POSTed to /api/v1/bot/*, showing up under that bot in your dashboard. Config edits on the dashboard are disabled for self-hosted bots - the source of truth is your webapp.

Why an npm package (not a runtime to clone)?

Cloning a separate repo, wiring env vars, and redeploying every time you tweak persona is friction. The npm package puts the whole bot inside your existing webapp - one deploy, one env, one config surface. Your LLM key stays in your backend; the platform never sees it.

Security

• Never put your LLM API key in the browser. Implement sendMessage against a same-origin /api/… route you own; call the model server-side. createOpenAIHandler helps but is server-only.
• The dashboard.token (pbt_…) grants conversation+lead writes for one bot only. Rotate it from the dashboard if it leaks.

Full docs

• Setup guide: https://pro-bot.dev/docs/self-hosted-bot/index
• Framework examples: https://pro-bot.dev/docs/self-hosted-bot/nextjs
• API reference: https://pro-bot.dev/docs/self-hosted-bot/api-reference

License

MIT