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

Step-by-step afternoon guide in the repo: docs/quickstart-afternoon.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 or use the CLI

    Run pnpm add @fluxy-chat/sdk in your app, or use create-fluxy-chat to scaffold a full project with Worker, SDK, and config pre-wired.

  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. Streaming markdown and tool calling work out of the box.

  4. Step 4

    Open the console for ops

    Manage rooms, agents, MCP tools, 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 AI agent invokes 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