Krisp Turn-Taking

The agent verb supports Krisp for two features:

• Turn detection — Krisp’s acoustic end-of-turn model analyzes speech patterns (not just silence) to determine when a user has finished speaking. This produces more natural conversations where users can pause mid-thought without the agent interrupting.
• Noise isolation — Krisp’s voice isolation removes background noise from the caller’s audio, improving STT accuracy in noisy environments.

Licensing Requirement

Obtaining a Krisp License

Contact support@jambonz.org to obtain a Krisp API key for your self-hosted deployment. We will provide:

1. Pricing information based on your expected usage
2. Your Krisp API key
3. Configuration instructions for your deployment

Configuration

Once you have obtained your Krisp API key, configure it on your jambonz system using one of the methods below.

New Deployments

When deploying jambonz via AWS CloudFormation or Terraform, provide your Krisp API key as a parameter or input variable during installation. The deployment scripts will configure the system automatically.

Existing Deployments

For systems already deployed, add the Krisp API key to the FreeSWITCH service configuration on the feature-server or mini:

1. Edit the FreeSWITCH systemd service file:

   $
   sudo vi /etc/systemd/system/freeswitch.service

2. Locate the KRISP_LICENSE_KEY environment variable and add your API key:

   1
   Environment="KRISP_LICENSE_KEY=your-api-key-here"

3. Reload systemd and restart FreeSWITCH:

   $
   sudo systemctl daemon-reload
   $
   sudo systemctl restart freeswitch

Verify Configuration

Once configured, you can use Krisp features in the agent verb:

1
session.agent({
2
  llm: { vendor: 'openai', model: 'gpt-4.1-mini', /* ... */ },
3
  turnDetection: 'krisp',           // Enable Krisp turn detection
4
  noiseIsolation: 'krisp',          // Enable Krisp noise isolation
5
  // ...
6
}).send();

Alternatives Without Krisp

If you don’t have a Krisp license, you can still build effective voice agents using these alternatives:

Turn Detection Alternatives

Noise Isolation Alternative

Usage in the Agent Verb

Turn Detection

1
// Krisp turn detection with custom threshold
2
session.agent({
3
  turnDetection: {
4
    mode: 'krisp',
5
    threshold: 0.5  // 0.0-1.0, lower = more aggressive
6
  },
7
  earlyGeneration: true,  // Enable speculative LLM prompting
8
  // ...
9
}).send();

Noise Isolation

1
// Krisp noise isolation with custom settings
2
session.agent({
3
  noiseIsolation: {
4
    mode: 'krisp',
5
    level: 80,           // 0-100, higher = more aggressive
6
    direction: 'read'    // 'read' (caller audio) or 'write' (outbound)
7
  },
8
  // ...
9
}).send();

See the agent verb reference for complete documentation of these parameters.