talkform

Talkform

Turn any form into a live audio interview.

Talkform is a config-driven audio intake utility. Products define the fields they need, Talkform asks for them conversationally, binds structured values directly into the form, and exports JSON-ready session results.

Workspace

• apps/web: hosted app for talkform.ai
• packages/core: config schema, realtime prompt/tool generation, session/result helpers
• packages/react: embeddable React widget
• packages/http: process-local transient session and HTTP helpers
• packages/cli: agent-friendly CLI
• packages/mcp: local MCP schema, template, and config-validation server
• docs: markdown documentation rendered in the web app

Core commands

pnpm install
pnpm dev
pnpm build
pnpm typecheck

Environment

• OPENAI_API_KEY
• OPENAI_REALTIME_MODEL default gpt-realtime-2.1
• OPENAI_REALTIME_VOICE default marin
• TALKFORM_ENABLE_IMPORT_AI_REFINEMENT optional; only true enables paid AI copy refinement after deterministic import
• NEXT_PUBLIC_AUDIOFORM_VENDOR
• NEXT_PUBLIC_AUDIOFORM_VENDOR_URL

Transient session APIs and public Realtime client-secret issuance are disabled in hosted production by default. A production deployment needs a durable session store, a distributed rate limiter, and server authentication before those endpoints should be enabled. The current in-memory store and quotas are development/reference implementations; they do not provide cross-instance durability or enforcement.

Machine clients use two matching environment variables:

• TALKFORM_API_TOKEN: server-only bearer token accepted by the web API
• AUDIOFORM_API_TOKEN: client-side token read by the Talkform CLI

For a controlled deployment, TALKFORM_ENABLE_IN_MEMORY_SESSIONS=true and TALKFORM_ENABLE_PUBLIC_REALTIME=true opt into the reference endpoints. Do not use these flags to represent the current process-local implementations as production-ready infrastructure.