Skip to content

admildo/kollect

Repository files navigation

Kollect — Conversational AI Forms 🎙️

Filling out forms can be boring. The longer the form, the worse it feels.

Kollect turns traditional forms into real-time AI-powered conversations. Instead of typing into static inputs, users speak naturally — and the AI dynamically guides them through a survey like a human would.

Kollect also makes form creation easier. Instead of manually configuring fields, you can describe the form you want — and AI helps generate it.


Why Kollect?

  • 🧠 AI understands speech in real time
  • 🎙️ Voice-based conversational surveys
  • ⚡ Dynamic question routing
  • 🛠️ AI-assisted form creation
  • 🔄 Real-time reactive database
  • 🔐 Authentication & bot protection
  • 🌍 Fully open source

This version is built for curious builders who want to learn how real-time AI systems work end-to-end.


ech Stack

Kollect is built using modern, production-ready tools:

  • Next.js – Full-stack React framework with Server Actions
  • Deepgram – Real-time speech-to-text & voice agent workflows
  • OpenRouter – Unified inference provider for top AI models
  • Vercel AI SDK – Structured outputs, tools, AI workflows
  • Convex – Real-time reactive database
  • Clerk – Authentication
  • Cloudflare Turnstile – Bot prevention
  • TailwindCSS – Styling
  • Vercel – Hosting

Special thanks to the teams at Vercel, Deepgram, and Convex — the web is better because of you.


🚀Getting Started

1️⃣ Clone the repository

git clone <your-repo-url>
cd kollect

2️⃣ Install dependencies

npm install

Configure Environment Variables

Create a .env.local file:

cp sample.env .env.local

Then add your keys:

DEEPGRAM_API_KEY=

OPEN_ROUTER=

# Convex
CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=

# Clerk
CLERK_JWT_ISSUER_DOMAIN=
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_FORCE_REDIRECT_URL="/home"
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL="/home"

# Cloudflare Turnstile
NEXT_PUBLIC_TURNSTILE_SITE_KEY=
TURNSTILE_SECRET_KEY=

Required Services

You’ll need accounts for:

  • Deepgram (voice AI)
  • OpenRouter (LLM inference)
  • Convex (database)
  • Clerk (authentication)
  • Cloudflare (Turnstile bot protection)
  • Vercel (deployment)

4️⃣ Run the App

Development mode:

npm run dev

Then open:

http://localhost:3000

Make sure to:

  • Allow microphone access
  • Sign in with Clerk
  • Try generating a form using natural language
  • Start a voice survey

How It Works

  1. User describes a form → LLM generates structured schema
  2. Schema is stored in Convex
  3. User starts survey
  4. Deepgram streams speech → AI processes → next question selected
  5. Responses saved in real time

The result: a form that feels like a conversation.


Open Source

Kollect is fully open source and intended as a learning resource for:

  • Real-time AI applications
  • Voice agent systems
  • Structured AI outputs
  • Agentic workflows
  • Full-stack AI architecture

If you're curious about building AI-native products, this project is for you.


Feedback

I built this version to explore how conversational AI can improve user experience. Excited to hear what you think

About

kollect AI realtime survey

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors