whirlchat / whirl

Whirl 
 The AI chat app that sweats the details. Every top model, real memory, 
 living documents, and your own tools, in one fast and friendly place.
 whirl.chat ·
 Self-hosting ·
 Architecture ·
 Contributing 
---
Whirl is a full-stack AI chat app built on Next.js and Convex. It's the code
behind whirl.chat, published in full under the MIT
license. Read it, run your own, or help make it better.
## Features
- **Every top model** in one conversation, routed through
 OpenRouter, with adjustable thinking levels.
- **Living artifacts:** documents, charts, and full interactive pages that
 stay editable in a side panel and can be shared by link.
- **Integrations** with your own tools over MCP (OAuth included), plus
 installable skills that teach Whirl new tricks.
- **Long-term memory** that carries preferences and projects across chats.
- **Live web search** and page reading for answers grounded in today's web.
- **Locked chats**, encrypted on your device with a password the server never
 sees, answered only by zero-retention models.
- **Incognito mode**, message queueing, voice input, image generation, file
 attachments, folders, sharing, and a lot of care around motion and polish.
- **Light and dark mode**, accent colors, and an installable mobile web app.
## Tech stack
| Layer | What it uses |
| --------- | -------------------------------------------------------------------- |
| Web app | Next.js 16, React 19, Tailwind CSS v4, Motion |
| Backend | Convex: database, functions, streaming, crons |
| Auth | Clerk |
| Models | OpenRouter via the AI SDK |
| Tooling | Bun workspaces, TypeScript |
Everything beyond Convex, Clerk, and OpenRouter is **optional** and switches
on with its own keys: billing (Autumn), web search (Exa), memory
(Supermemory), analytics (PostHog, Axiom), tracing (Braintrust), email
(Resend), and the support agent (Median). Leave them out and Whirl hides the
features they power. See docs/configuration.md.
## Quick start
You'll need Bun, a free Convex
account, a Clerk application, and an
OpenRouter API key.
 [code] 
Open localhost:3000 and say hi. The
self-hosting guide covers each step in detail,
including the Clerk JWT template Convex needs and how to deploy to
production.
## Repository layout
 [code] 
## Documentation
- Self-hosting: run Whirl locally and in production
- Configuration: every environment variable and
 what it switches on
- Architecture: how a message travels from the
 composer to the model and back
- Contributing: conventions, checks, and pull requests
## Contributing
Bug reports, ideas, and pull requests are all welcome. Start with
CONTRIBUTING.md, and please follow the
code of conduct. Found a security issue? See
SECURITY.md.
## License
MIT © Anterra