https://github.com/bobld/snipsnlu
Snips NLU C# wrapper library to extract meaning from text
https://github.com/bobld/snipsnlu
natural-language-processing natural-language-understanding nlp nlu nlu-engine snips snips-nlu
Last synced: 6 months ago
JSON representation
Snips NLU C# wrapper library to extract meaning from text
- Host: GitHub
- URL: https://github.com/bobld/snipsnlu
- Owner: BobLd
- Created: 2019-05-26T10:53:31.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T05:36:50.000Z (almost 3 years ago)
- Last Synced: 2025-04-06T07:38:52.568Z (6 months ago)
- Topics: natural-language-processing, natural-language-understanding, nlp, nlu, nlu-engine, snips, snips-nlu
- Language: C#
- Size: 13.5 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Snips NLU C#
============
Snips NLU C# wrapper library to extract meaning from text
References
----------
- https://snips.ai/
- https://github.com/snipsco/snips-nlu
- https://github.com/snipsco/snips-nlu-rs/
What is Snips NLU about ?
-------------------------
[From https://github.com/snipsco/snips-nlu/blob/develop/README.rst]
Behind every chatbot and voice assistant lies a common piece of technology: Natural Language Understanding (NLU). Anytime a user interacts with an AI using natural language, their words need to be translated into a machine-readable description of what they meant.
The NLU engine first detects what the intention of the user is (a.k.a. intent), then extracts the parameters (called slots) of the query. The developer can then use this to determine the appropriate action or response.
Version
-------
0.64.3
x86 and x64 libraries
---------------------
The pre-built DLL files are available in there respective directories.
### Some useful resources:
- https://www.reddit.com/r/rust/comments/78vpxg/help_cross_compiling_for_32_bit_on_windows/
- https://www.reddit.com/r/rust/comments/a5guk3/cant_use_i686pcwindowsmsvc/
- https://gist.github.com/InNoHurryToCode/955d63db0d79699fed63fe18eeebf17e
- https://github.com/japaric/rust-cross#the-target-triple
### Building the DLLs
#### For Windows
To build the dll, in `Cargo.toml` set `crate-type` to `["cdylib"]`. In `\.rustup\settings.toml`, it might be necessary to change `default_host_triple` to `i686-pc-windows-msvc` or to `x86_64-pc-windows-msvc`.
To check if the necessary toolchains are installed, run `rustup toolchain list`.
- __x86 build__
If necessary, run the following to install the toolchain:
```
rustup install stable-i686-pc-windows-msvc
```
Then run:
```
cargo build --release --target=i686-pc-windows-msvc
```
- __x64 build__
If necessary, run the following to install the toolchain:
```
rustup install stable-x86_64-pc-windows-msvc
```
Then run:
```
cargo build --release --target=x86_64-pc-windows-msvc
```
Code Examples
-------------
Load a Model from a folder:
``` C#
using (var snipsNLUEngine = SnipsNLUEngine.CreateFromDirectory(@"Data\Tests\Models\nlu_engine"))
{
IntentClassifierResult[] intents = snipsNLUEngine.GetIntents("Can you make 3 cups of coffee?");
Slot[] slots = snipsNLUEngine.GetSlots("Can you make 3 cups of coffee?", intents[0].IntentName);
// or
IntentParserResult parsed = snipsNLUEngine.Parse("Can you make 3 cups of coffee?");
Console.WriteLine(parsed);
}
```
or
``` C#
using (var snipsNLUEngine = new SnipsNLUEngine(@"Data\Tests\Models\nlu_engine"))
{
IntentClassifierResult[] intents = snipsNLUEngine.GetIntents("Can you make 3 cups of coffee?");
Slot[] slots = snipsNLUEngine.GetSlots("Can you make 3 cups of coffee?", intents[0].IntentName);
// or
IntentParserResult parsed = snipsNLUEngine.Parse("Can you make 3 cups of coffee?");
Console.WriteLine(parsed);
}
```
Load a Model from a Zip file:
``` C#
using (var snipsNLUEngine = SnipsNLUEngine.CreateFromZip(@"Data\Tests\Models\nlu_engine.zip"))
{
IntentParserResult parsed = snipsNLUEngine.Parse("Can you make 3 cups of coffee?");
Console.WriteLine(parsed);
}
```
Output will be:
```
Can you make 3 cups of coffee?
MakeCoffee (61.43%)
'3 (Number)', '3', snips/number, number_of_cups @ [13;14]
```
TO DO list
----------
- [x] Load model from zip file
- [ ] Implement `CStringArray` class
- [ ] Implement `intentsWhitelist` and `intentsBlacklist` in `SnipsNLUEngine.Parse()`
License
-------