Embeddable AI assistant for web apps: a Spring Boot backend + SDK that lets a coding agent scan your repo and push tools, navigation flows, and knowledge live, plus a Next.js dashboard to manage assistants and a drop-in browser widget.

ActBrow is an in-app AI agent runtime — embed an AI agent that navigates your app with two script tags, no backend rewrite. See the React example, Vue example, or self-hosting guide · Book a demo.

• Backend — Spring Boot (Java 21), PostgreSQL, OpenAI-compatible model provider (OpenRouter, or a local Claude-CLI proxy for dev).
• UI — Next.js dashboard (ui/) that proxies /api/* to the backend.
• Widget/SDK — actbrow-sdk.js + actbrow-widget.js, served by the backend.

cp .env.example .env            # optional: fill in model/OAuth/mail values
docker compose up --build

• UI → http://localhost:3000
• API → http://localhost:8080 (health: /health)
• Postgres → localhost:5432

This brings up Postgres, the backend, and the UI together. Google login and the model provider need real credentials (see Configuration); the app boots without them for local exploration.

Backend:

# needs a running Postgres matching SPRING_DATASOURCE_* (see .env.example)
./mvnw spring-boot:run

UI:

cd ui
cp .env.example .env.local      # point NEXT_PUBLIC_API_PROXY_TARGET at your backend
npm install
npm run dev                     # http://localhost:3000

Backend env vars (see .env.example); the committed src/main/resources/application.properties reads them via ${VAR:default}:

UI env vars: see ui/.env.example. NEXT_PUBLIC_* values are inlined into the browser bundle — never put secrets there.

./mvnw test          # backend
cd ui && npx tsc --noEmit   # UI type check

MIT