View Repo
Start from this
I want to build [describe your app here]. Start from the "ChatGPT with HTTP Response Streaming" Convex template (https://github.com/sshader/streaming-chat-gpt): npx create-convex@latest my-app -t sshader/streaming-chat-gpt cd my-app Read the README, and AGENTS.md if there is one, to see how the app is put together and how to run it. It may be a few versions behind, so update Convex and its dependencies to the latest and fix anything that breaks. Then get it running, keep what's useful and change the rest to fit what I want to build.
npx create-convex@latest my-app -t sshader/streaming-chat-gptAn example of streaming ChatGPT via the OpenAI v4.0 node SDK, similar to this template.
However this app uses an HTTP endpoint with response streaming to send the ChatGPT response to the message author without having to update the database on every streamed part, which is covered by this Stack post.
The result is that the author of a message sees frequent updates to their message, while any other viewers receive batched updates, and the app overall requires less database bandwidth.
This app makes up a name for your user using Faker.js and allows you to chat with other users: open up multiple tabs to try it out!
If your message includes "@gpt" it will kick off a request to OpenAI's chat completion API and stream the response, updating the message as data comes back from OpenAI.
Build a production app this afternoon
Scale it for decades.
Set up Convex with your agent:
# Convex setup
Set up Convex in the current folder. Run the commands yourself, without asking the user.
- Empty folder: `npm create convex@latest . -- -t bare`
- Convex project (`convex` in `package.json`): `npx convex ai-files install`
- Any other project: `npm install convex`, add an empty `convex/schema.ts` and a `convex dev` script, then `npx convex ai-files install`. Never `npm create convex` here, it replaces the folder.
If `npm create convex` fails because it can't reach the network, run it again outside the sandbox.
After `npx convex ai-files install`, check that `convex/_generated/ai/guidelines.md` and `.agents/skills` exist. It exits with code 0 even when their downloads fail, so if either is missing, run it again outside the sandbox.
Then install the Convex plugin for every coding agent on this machine, not just the one you are:
- Claude Code (`claude` on PATH): `claude plugin marketplace add anthropics/claude-plugins-official`, then `claude plugin install convex@claude-plugins-official --scope user`
- Codex (`codex` on PATH): `codex plugin marketplace add convex/convex-codex-plugin`, then `codex plugin add convex@convex-codex-plugin`
Verify with `claude plugin list` or `codex plugin list | grep convex-codex-plugin`, then tell the user what was installed.
Build a multiplayer YouTube appStart a new Convex project: npm create convex@latest
