Skip to content
CleverKeys Wiki

Neural Prediction Settings

Fine-tune the neural network-based swipe typing predictions for accuracy and performance.

Quick Summary

WhatDescription
PurposeOptimize neural predictions
AccessScroll to Neural Prediction section in Settings
Key SettingBeam Width controls accuracy vs speed

Settings Location

In Settings, scroll to the Neural Prediction section (collapsible). All neural prediction settings are here.

Understanding Neural Predictions

CleverKeys uses an ONNX neural network to predict words from swipe gestures. The model processes your swipe trajectory and outputs probability distributions for each letter position.

Key Settings

Swipe Typing

Master toggle to enable/disable swipe input:

SettingEffect
OnSwipe typing enabled
OffSwipe gestures disabled

Swipe on Password Fields

Allow swipe typing in password fields:

SettingEffect
OnSwipe works in password fields
OffOnly tap typing in password fields (default)

Beam Width

The most important setting for prediction quality. Controls how many parallel word candidates the decoder tracks:

WidthEffect
3-4Faster, may miss less common words
6Balanced (default)
8-12More thorough search, finds rare words
16-20Maximum accuracy, slower

[!NOTE] Higher beam width = more word candidates explored = better accuracy but slightly slower. Range: 1-20.

Confidence Threshold

Minimum score for a prediction to be shown:

  • Lower = more suggestions, some may be weak
  • Higher = only confident predictions shown

Max Word Length

Maximum predicted word length in characters (default: 20). Longer words will be truncated.

Full Neural Settings

For advanced tuning (batch processing, greedy search, ONNX threads, beam search parameters, inference tuning, and presets), tap the Full Neural Settings button at the bottom of the Neural Prediction section. This opens a dedicated activity with all neural parameters.

Tips and Tricks

  • Accuracy issues: Increase beam width from 6 to 8 or 10
  • Slow predictions: Reduce beam width to 4-5
  • Missing words: Check that multi-language is configured correctly
  • Long words wrong: Increase beam width

[!TIP] Start with the default beam width of 6. Only adjust if you notice specific issues.

All Neural Settings

SettingDefaultRange/Options
Swipe TypingOnOn/Off
Swipe on Password FieldsOffOn/Off
Beam Width61-20
Confidence Threshold0.010.01-0.5
Max Word Length205-50
ONNX Threads21-8

Common Questions

Q: Why are predictions slow?

A: Reduce beam width from 6 to 4-5. Also check if multiple languages are enabled, which increases processing.

Q: Why does it suggest wrong words?

A: Try increasing beam width for more thorough search. Also ensure your primary language is set correctly in Multi-Language section.

Q: How do I add words to the dictionary?

A: Type the word and tap it in predictions to add it to your personal dictionary.

Q: Can I reset neural settings?

A: Use Settings > Backup & Restore to reset to defaults.

Technical Details

The neural model is:

  • Format: ONNX (Open Neural Network Exchange)
  • Architecture: Encoder-decoder transformer
  • Input: Normalized swipe coordinates (x, y, time)
  • Output: Per-position letter probabilities
  • Decoding: Beam search with vocabulary constraint