What do you want to do?
4 use cases
-
Run your own copy of the Whirl chat app
Clone the repo, connect Convex, Clerk, and OpenRouter, and chat with models from your own deployment.
- Whirl
- Software and DevOps
- Intermediate
View prompt
In the whirlchat/whirl repo, follow the Quick start in the README to run the web app locally using my Convex, Clerk, and OpenRouter values in <placeholder-env-file>. Report the URL the app is serving on and whether a test message to a model returns a reply. Verify that bun run dev starts without errors before reporting success.
-
Give a team chat access to its own tools via MCP
Add MCP integrations, with OAuth, so Whirl can work with the tools your team already uses.
- Whirl
- Software and DevOps
- Advanced
View prompt
In the whirlchat/whirl repo, read the apps/console directory and the docs/configuration.md file, then describe how to add an MCP integration with OAuth for <target-tool>. Output the exact steps and any environment variables needed. Verify each claim against the README or docs before reporting.
-
Keep sensitive chats locked on your device
Use locked chats so messages are encrypted on your device and answered only by zero-retention models.
- Whirl
- Software and DevOps
- Intermediate
View prompt
In the whirlchat/whirl repo, read the README's Locked chats feature and the docs/architecture.md file, then explain how a locked chat is encrypted and which models answer it. Output a short summary with two cited facts. Verify that every claim appears in the README or docs.
-
Run research chats with memory and live web search
Enable web search, page reading, and long-term memory so answers use today's web and past context.
- Whirl
- Software and DevOps
- Intermediate
View prompt
In the whirlchat/whirl repo, open docs/configuration.md and list the exact environment variable names for Exa and Supermemory. Output them as a table with the feature each one enables. Verify each name against the file before reporting.
How to use Whirl
- Check you have what it needs: Bun installed; A free Convex account; A Clerk application.
- Open whirlchat/whirl on GitHub and read the README and license.
- Run
git clone https://github.com/whirlchat/whirl.gitand thencd whirl. - Run
bun installfrom the repo root. - Run
cd packages/backendthenbunx convex devand finish the first-run project setup. - In another terminal, run
bunx convex env set CLERK_JWT_ISSUER_DOMAIN https://your-instance.clerk.accounts.devandbunx convex env set OPENROUTER_API_KEY sk-or-v1-....
These steps come from our top use case, Run your own copy of the Whirl chat app, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers and teams who want to run their own AI chat app with their own keys, data, and tools instead of using a hosted chat product.
- Why it is hot
- LanguageTypeScript
- Sourcegithub.com/whirlchat/whirl · Back to Hot repos
Requirements
- Bun installed
- A free Convex account
- A Clerk application
- An OpenRouter API key
- Git and a terminal
Maintain Whirl? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/whirlchat-whirl/?ref=badge)
Questions about Whirl
What is Whirl?
Whirl is an open source, MIT licensed AI chat app built on Next.js and Convex that routes many models through OpenRouter, with memory, artifacts, and MCP tool integrations. It is an open-source project on GitHub: https://github.com/whirlchat/whirl.
Who is Whirl for?
Developers and teams who want to run their own AI chat app with their own keys, data, and tools instead of using a hosted chat product.
What can I do with Whirl?
4 use cases so far, for example: Run your own copy of the Whirl chat app; Give a team chat access to its own tools via MCP; Keep sensitive chats locked on your device. Each has steps and a copy-paste agent prompt.
What do I need to run Whirl?
Bun installed; A free Convex account; A Clerk application; An OpenRouter API key.
What are alternatives to Whirl?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Whirl safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.