ConvoForm transforms traditional, static forms into interactive, AI-powered conversational experiences. It makes data collection engaging and intuitive—like talking to a human, but scalable.
- AI-Powered Generation: Describe your needs, and let AI build the form for you.
- Conversational Interface: Users answer questions in a chat format rather than filling out input fields.
- Smart Validation: AI validates responses in real-time and asks follow-up questions if needed.
- Real-Time Editor: See changes instantly as you edit your form.
- Customizable: Brand your submission pages to match your identity.
Visit our Documentation Site for detailed guides, concepts, and API references.
- Node.js (v22+)
- pnpm (v10.8.1)
- Bun (v1.2+ — runs the websocket server)
- PostgreSQL (local or hosted — the app validates
DATABASE_URLat startup) - Docker (optional, for self-hosting)
-
Clone the repo
git clone https://github.com/growupanand/ConvoForm.git cd ConvoForm -
Install dependencies
pnpm install
-
Configure Environment
cp .env.example .env # Fill in the required keys in .env (the comments in .env.example explain each one): # AI provider, Clerk auth, Resend email, database URL, etc. # IMPORTANT: generate a strong ENCRYPTION_KEY for securing integration tokens. # You can generate one using `openssl rand -hex 32`
-
Run Development Server
pnpm run dev
Visit http://localhost:3000 for the web app, http://localhost:3001 for the documentation, http://localhost:4000 for the websocket server, and http://localhost:4001 for the channels server (Telegram webhooks).
We love contributions! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.
To report a security vulnerability, see SECURITY.md.
This project is open-sourced under the Apache License 2.0.