Beta build. Report issues to your operator channel.
fluxychat

Sign in to unlock the console sidebar

Sign in to provision hosted cloud, or run the wizard with a manual admin JWT if you self-host.

Quickstart wizard

Quickstart

Get your first message live

Account, SDK, first room on hosted cloud. Self-hosting is optional — see advanced. Positioning and tradeoffs: /why.

SDK quickstart

pnpm add @fluxy-chat/sdk
NEXT_PUBLIC_FLUXYCHAT_CLOUD_URL=https://api.fluxychat.com
const { messages, sendMessage, loadHistory } = useChat({
  roomId: "assistant:general",
  replay: "connect", // or "request" + loadHistory() for heavy rooms
});

Custom bots: FluxyMessageStream — see docs/cookbook/bot-streaming-fluxy-message-stream.md

  1. Step 1

    Create your account

    Sign up on Fluxychat Cloud. We provision a project and API credentials — no Worker deploy on day one.

  2. Step 2

    Install the SDK

    Run pnpm add @fluxy-chat/sdk in your app and set baseUrl to the hosted API URL from the console.

  3. Step 3

    Send your first message

    Mint a member JWT on your backend (or use the wizard), join a room, and render chat with useChat.

  4. Step 4

    Open the console for ops

    Manage rooms, agents, quotas, and billing once you are signed in.

  5. Step 5

    Upgrade when you need more

    Start on the free tier. Move to a paid plan in the console when quotas or agents become a bottleneck.

View docsProduct overview

Self-host on Cloudflare (advanced)

Deploy the Worker and D1 from the monorepo when you need your own Cloudflare account or an isolated tenant. Most teams start on hosted cloud and move here when compliance or scale asks for it.

  • Fork or clone the repo, deploy apps/worker
  • Set NEXT_PUBLIC_FLUXYCHAT_WORKER_URL in your app
  • Mint JWTs with your project API key — see docs/cookbook/auth-jwt.md

Worker README on GitHub · Manual setup wizard