Skip to main content

Your help centre, answering inside your app.

sideagent adds an assistant to your product that answers from your own help centre. Every answer shows its source, and questions your docs do not cover are declined.

Open source under MIT. Install it with npm i sideagent.

Your users ask support what your help centre already explains.

Each of those questions costs an agent's time and a user's patience. The answer exists, but it sits on a page the user never opened.

sideagent brings that page into the screen where the question comes up.

Add it to your own stack.

One package holds both halves: a server you mount in your backend, and a React chat for your frontend. No training data to prepare. sideagent reads the help centre you already have.

  1. Step 1

    Install the package

    The same package serves your backend and your frontend.

    npm i sideagent
  2. Step 2

    Mount the server

    One call gives you the dashboard, its sign-in, the agent endpoints and the audit log. It needs Postgres with pgvector, a public URL and a secret of 32 or more characters. Run it on Node, or mount server.fetch in Hono, Next.js or Cloudflare Workers.

    import { createServer } from "sideagent/server/node";
    
    const server = createServer({
      database: process.env.DATABASE_URL,
      publicUrl: "https://agent.example.com",
      secret: process.env.SIDEAGENT_SECRET,
    });
    await server.listen(8788);
  3. Step 3

    Set up an agent in the dashboard

    Add your help-centre URLs or Markdown, choose the model, list the sites allowed to show the chat, and try questions in the preview. Switch the agent to Active and copy its publishable key.

    Knowledge: URLs or Markdown, each shown as Queued, Indexed or FailedModel and its API key, sealed at restAllowed origins for the chatPreview, then Active
  4. Step 4

    Add the chat to your app

    The publishable key is safe in the browser. Pass getToken so each conversation belongs to the signed-in user.

    import { AgentChat } from "sideagent";
    
    <AgentChat
      publishableKey="pk_…"
      getToken={() => auth.getAccessToken()}
    />

On sideagent Cloud, coming soon, steps 1 and 2 are done for you: add your knowledge, set the rules and paste the component.

Secure by default.

An assistant inside your product speaks for your company. These safeguards are on from the first install, with nothing to configure.

  • Only sites you list can use the chatRequests from other origins, or with the wrong method or content type, are refused.
  • A conversation belongs to its userOne customer cannot open or continue another customer's thread.
  • Docs reach the model as untrusted dataInstructions hidden in a fetched page are wrapped and labelled as data, which limits prompt injection.
  • Fetched URLs pass an SSRF guardAdding a knowledge URL cannot make the server read your internal network.
  • Raw passages stay off the browserUsers receive the answer and source titles, not the search results behind them.
  • Provider errors stay on the serverUsers never see a raw model error or provider detail.
  • Model keys are sealedKeys are encrypted in the database and never returned by the dashboard.

What your business gets.

Fewer repeat questions to support

Users get the answer in the app, at any hour, without opening a ticket. Your team keeps its time for cases that need a person.

Support leads

Answers your team can check

Each answer lists the pages it came from. Questions your docs do not cover are declined, so the assistant does not invent prices, policies or features.

Product and docs owners

Fewer open questions in security review

The safeguards above are on by default, and the code is open, so your reviewers can check them themselves.

Security and compliance

Built for signed-in users

Conversations are tied to each user's session, and history is kept per user, so the assistant fits inside an authenticated app.

Engineering

Your data, your model

Choose the model and pay the provider directly. Self-host when the data must stay on your servers.

Finance and IT

Looks like your product

A floating button or a sidebar docked beside your app, light and dark modes, and your own colours and font through CSS variables.

Design

The same product, run by us or by you.

Cloud

Coming soon

We run the server, database and upgrades. You add your docs and paste the component.

  • Three steps: add your knowledge, set the rules, paste the component
  • Dashboard, team sign-in and audit log included
  • No server or database to operate

Self-hosted

Available now

Run it on your own infrastructure. Free under the MIT licence.

  • Postgres with pgvector, on Node or Cloudflare Workers
  • Mounts inside your own server: Hono, Next.js or Express
  • The same dashboard and security defaults
  • Data stays on your servers, apart from the model and embedding providers you choose
Read the self-hosting guide

What we are building next.

The first priority is showing you what the assistant saves.

See all
  • Insights dashboard. See what users ask, which questions got no answer, and which pages are cited most.
  • Answer feedback. A thumbs up or down on each answer, with an optional reason.
  • Handoff to your team. When the docs do not cover a question, offer a contact step that sends the conversation to email or your helpdesk.