Documentation

Embed an AI agent in your app — two script tags

ActBrow is an in-app AI agent runtime. It navigates your app, calls your APIs over REST, runs flows, and answers from your docs — added with two script tags and no backend rewrite.

1. Add the embed snippet

Paste this before the closing </body> tag. Create an assistant in the dashboard to get your assistantId and API key.

<script src="https://actbrow-backend.depak.dev/actbrow-sdk.js"></script>
<script>
window.ActbrowWidgetConfig = {
  assistantId: "YOUR_ASSISTANT_ID",
  baseUrl: "https://actbrow-backend.depak.dev",
  apiKey: "wk_...",
  navigate: function (path) { window.location.assign(path); }
};
</script>
<script src="https://actbrow-backend.depak.dev/actbrow-widget.js"></script>

2. Execute tools over REST

When the agent calls a client tool, your app posts the result back over REST. No SDK-specific plumbing — just HTTP.

POST /v1/runs/{runId}/tool-results
Content-Type: application/json

{
  "toolCallId": "call_123",
  "success": true,
  "structuredOutput": "{\"order\":\"shipped\"}",
  "textSummary": "Order #4021 is shipped"
}

Framework guides

FAQ

How do I embed an AI agent in my web app?

Add two script tags before the closing body tag: actbrow-sdk.js, a small ActbrowWidgetConfig object with your assistant id and API key, and actbrow-widget.js. The agent goes live with no backend rewrite.

Does ActBrow require a backend rewrite?

No. ActBrow runs as a two-script embed on top of your existing app. Tools are executed over REST, so you expose the endpoints you already have instead of rebuilding your backend.

Can I self-host ActBrow?

Yes. ActBrow ships as a Docker image you can run on your own infrastructure. See the self-hosting guide for docker-compose and environment configuration.

Which frameworks does the embed work with?

Any web app — the embed is framework-agnostic. There are first-class examples for React and Vue, and the same two script tags work in plain HTML.