Skip to content

Repository files navigation

IMStage

Create conversations. Refine every detail.

Try IMStage → · 简体中文 · Contribute

IMStage: an editable WhatsApp scene and a prompt to start creating

Make product demos, teaching examples and fictional stories with chat scenes. Start with an idea, edit the scene directly, and export the frame you need.

  • Edit directly. Change messages, people, avatars, timestamps and device settings. Undo mistakes and keep separate local sessions.
  • Create with words. The hosted Agent can draft and revise a scene after sign-in. Reference screenshots support reconstruction and focused edits.
  • Reuse your work. Save editable templates, expose names and photos as variables, and create project variations with shared rules. Customize the layout beyond app skins.
  • Export the result. Download a normal frame or a long PNG, or keep the editable scene as JSON. Preview and export share one renderer.
  • Use your own tools. Self-host the account API and Agent, or connect a client to the authenticated MCP service.

Chinese examples use WeChat; English examples use WhatsApp. Scroll through a scene, change a line and explore variations. Send & create opens a fresh workspace and starts your request after sign-in. Your scenes, people and project settings save automatically; local drafts keep edits available when a cloud save fails.

Run locally

Use Node.js 22.18–22.x.

npm ci
npm run dev

Open localhost:4417. To build and run the production app:

npm run build
npm start

Configure server-side provider credentials to use the Agent. Manual editing and PNG export work without provider keys.

Hosting and integrations

The hosted website uses Vercel for the frontend and a persistent server for accounts, saved scenes and Agent requests. Provider secrets stay on the server. Local sessions stay in the current browser. Signed-in scene, people and project-setting edits automatically sync to the server. AI requests send their scene, attachments and instruction to the configured providers.

Connect ChatGPT through the account connection page. The account MCP endpoint (/api/mcp) uses OAuth login and shares your Web saved scenes. You can revoke connections or create personal tokens from your account. ChatGPT currently requires manual setup; public directory installation is not available.

Self-hosted /mcp retains its administrator-configured instance token and separate scene store. Its batch tools save content supplied by the calling AI; Web project batches run the hosted Agent. Billing and email password recovery are not implemented. See ChatGPT connections for the two endpoints.

Templates and batch creation · Deploy and operate · Account API · Agent configuration · MCP tools

Development

npm test
npm run test:ui  # Playwright; installed Google Chrome by default

For bundled Chromium, run npx playwright install chromium, then IMSTAGE_BROWSER=chromium npm run test:ui. See contributing.

Templates approximate platform UI; screenshot reconstruction can need manual correction. Built-in conversations and portraits are fictional. Use authorized assets and do not present generated scenes as evidence of real conversations.

MIT. Independent of the messaging platforms shown.

About

Create editable conversation scenes for WeChat and WhatsApp. Export crisp PNGs, work in English or 中文, and self-host the API + MCP.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages