https://github.com/antirek/voicer
AGI-server voice recognizer for #Asterisk
https://github.com/antirek/voicer
agi asr asterisk dialplan google javascript recognition voice voice-assistant voice-commands voice-control voice-recognition yandex
Last synced: 22 days ago
JSON representation
AGI-server voice recognizer for #Asterisk
- Host: GitHub
- URL: https://github.com/antirek/voicer
- Owner: antirek
- License: mit
- Created: 2015-01-01T05:40:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-01-01T04:17:08.000Z (over 2 years ago)
- Last Synced: 2025-03-29T20:02:05.885Z (about 1 month ago)
- Topics: agi, asr, asterisk, dialplan, google, javascript, recognition, voice, voice-assistant, voice-commands, voice-control, voice-recognition, yandex
- Language: JavaScript
- Homepage:
- Size: 469 KB
- Stars: 98
- Watchers: 10
- Forks: 35
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
voicer
======
AGI voice recognizer for Asterisk [use Yandex, Google or Wit.ai ASR online services]
Call to special extension, say "Vasya" and Asterisk connect you with Vasya! Excellent!
[](https://travis-ci.org/antirek/voicer)
Workflow
========
Voicer work as AGI-server. Voicer accept request from asterisk via AGI app.
It run handler for each request. Handler command asterisk record file.
After this send file to recognition service, receive text, search by text in
source of data for finding concordance, if source have this text it return
channel for call, voicer set dialplan vars RECOGNITION_RESULT as SUCCESS and
RECOGNITION_TARGET for finded result.
After this voicer return control to dialplan. Build rules of dialplan using
RECOGNITION_RESULT and RECOGNITION_TARGET.
Use
===
## Install ##
> $ npm install voicer -g
## Run
> voicer -p 3000 -t google -k -d /etc/voicer/peernames.json -r /var/records
run with --help for instructions
> voicer --help
Configuration
=============
## Config.js ##
``````
{
agi: {
port: 3000
},
processing: {
totalAttempts: 2,
playGreeting: true,
playBeepBeforeRecording: false //use system beep
},
asterisk: {
sounds: {
onErrorBeforeFinish: 'invalid',
onErrorBeforeRepeat: 'invalid',
greeting: 'beep'
},
recognitionDialplanVars: {
status: 'RECOGNITION_RESULT',
target: 'RECOGNITION_TARGET'
}
},
record: {
directory: '/tmp',
type: 'wav',
duration: 2,
},
recognize: {
directory: '/tmp',
type: 'witai', // ['yandex', 'google', 'witai']
options: {
developer_key: '6SQV3DEGQWIXW3R2EDFUMPQCVGOEIBCR'
}
},
lookup: {
type: 'file',
options: {
dataFile: 'data/peernames.json'
}
}
};
``````
## Asterisk ##
Write dialplan for call to AGI-server voicer like
`````
[default]
exten=1000,1,AGI(agi://localhost:3000)
exten=1000,n,GotoIf($[${RECOGNITION_RESULT}=SUCCESS]?:default,1000,4)
exten=1000,n,Dial(${RECOGNITION_TARGET})
`````
## Format peernames ##
`````
[
....
{
"name": "Vasya",
"target": "SIP/Sf567890",
"variants": ["vasya", "vasya petrov"]
},
....
]
`````
[Online peernames.json constructor](https://antirek.github.io/voicer-web/)
## Errors?! ##
Bugs?! Oh, contact with me. I want to eat them.
## Links ##
Yandex API key: https://developer.tech.yandex.ru/
Google API key: https://console.developers.google.com/
Wit.ai API key: http://wit.ai
[Voice speed dial on Asterisk](http://habrahabr.ru/post/248263/)
[New manual](https://habr.com/ru/post/436016/)
[Use with FreePBX](https://voxlink.ru/kb/asterisk-configuration/golosovoj-nabor-v-asterisk/)
Development
===========
## Test ##
> npm test