Open source · TypeScript

Build production-ready Vapi agents in minutes.

Vokli turns business definitions into reusable receptionist agents, deterministic prompts and explicit Vapi configuration—without hiding the moving parts.

View on GitHub Read the docs
receptionist.ts
import { createVokli, receptionist }
  from "@vokli/sdk";

const agent = receptionist({
  id: "garage-martin",
  business: {
    name: "Garage Martin",
    language: "fr-FR",
    timezone: "Europe/Paris"
  },
  greeting: "Bonjour, comment puis-je vous aider ?",
  collect: {}
});

const vokli = createVokli({ vapi: config });
const generated = vokli.generate(agent);
Local generation is available now. Real Vapi deployment is the next implementation milestone.
01 / Why Vokli

Voice agents without the repeated plumbing.

Vokli is a focused layer above Vapi. It keeps provider details visible while standardizing the parts teams rebuild for every agent.

01

Business-first definitions

Describe the company, opening hours, greeting, fields to collect and conversation rules in readable TypeScript.

02

Deterministic output

Generate stable prompts and structured outputs that can be reviewed, tested and versioned like normal application code.

03

Knowledge with boundaries

Track static documents incrementally while keeping appointments, prices, stock and CRM data in real-time tools.

02 / The path

Explicit from input to provider config.

Each stage has one clear responsibility. No hidden framework, invented defaults or unnecessary abstraction layers.

receptionist()

Define

Express the business and the call experience.

validate()

Validate

Catch actionable errors before generating anything.

generate()

Generate

Create a stable prompt and local Vapi resources.

deploy()

Deploy

Idempotent Vapi deployment is the active milestone.

03 / Roadmap

Small releases. Honest capabilities.

The project documents what works today and keeps future functionality out of the public promise until it is implemented.

Shipped

Foundation

Human-readable agent definitions and provider-neutral core concepts.

  • Strict TypeScript monorepo
  • Receptionist template
  • Runtime validation
  • Prompt and schema generation
Now

Real Vapi integration

One client for assistant deployment and knowledge synchronization.

  • Idempotent deployment
  • Dry-run reports
  • Query Tool knowledge
  • Recoverable local state
Next

Production workflow

Reusable actions and confidence-building conversation tests.

  • Business tools
  • Webhook helpers
  • Conversation scenarios
  • First npm release

Help shape the developer layer Vapi is missing.

Vokli is open source and intentionally small. Read the code, challenge the architecture or contribute to the next milestone.

Explore Vokli on GitHub