https://github.com/gluschenko/panlingo
Collection of language detection libraries for .NET: FastText, CLD2, CLD3, MediaPipe, Lingua, Whatlang
https://github.com/gluschenko/panlingo
cld2 cld3 dotnet dotnet-core fasttext interop language-detection language-identification lingua machine-learning mediapipe neural-networks nlp whatlang wrapper
Last synced: 4 months ago
JSON representation
Collection of language detection libraries for .NET: FastText, CLD2, CLD3, MediaPipe, Lingua, Whatlang
- Host: GitHub
- URL: https://github.com/gluschenko/panlingo
- Owner: gluschenko
- License: other
- Created: 2024-06-20T18:35:53.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-18T21:30:32.000Z (4 months ago)
- Last Synced: 2025-06-18T22:30:17.801Z (4 months ago)
- Topics: cld2, cld3, dotnet, dotnet-core, fasttext, interop, language-detection, language-identification, lingua, machine-learning, mediapipe, neural-networks, nlp, whatlang, wrapper
- Language: C#
- Homepage:
- Size: 1.49 MB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
ο»Ώ# Panlingo
[](https://github.com/gluschenko/panlingo/actions/workflows/github-ci.yml)
## Overview
Welcome to the **Panlingo** repository! π
This project presents a comprehensive collection of language identification
libraries for .NET. Its primary purpose is to bring popular
language identification models to the .NET ecosystem,
allowing developers to seamlessly integrate language detection
functionality into their applications.
## Libraries
| Library | NuGet Package |
| :------ | :------------ |
| [Panlingo.LanguageIdentification.CLD2](./README_CLD2.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.CLD2/) |
| [Panlingo.LanguageIdentification.CLD3](./README_CLD3.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.CLD3/) |
| [Panlingo.LanguageIdentification.FastText](./README_FASTTEXT.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.FastText/) |
| [Panlingo.LanguageIdentification.Whatlang](./README_WHATLANG.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.Whatlang/) |
| [Panlingo.LanguageIdentification.MediaPipe](./README_MEDIAPIPE.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.MediaPipe/) |
| [Panlingo.LanguageIdentification.Lingua](./README_LINGUA.md) | [](https://www.nuget.org/packages/Panlingo.LanguageIdentification.Lingua/) |
| [Panlingo.LanguageCode](./README_LANGUAGE_CODE.md) | [](https://www.nuget.org/packages/Panlingo.LanguageCode/) |
## Contents
1. [Models](#models)
2. [Features](#features)
3. [Platform Support](#platform-support)
4. [Key Concerns](#key-concerns)
5. [Contributing](#contributing)
6. [License](#license)
## Models
| Model | Authors | License | Original source code | Wrapper docs |
| :------------ | :------------------- | :--------- | :------------------- | :------------------- |
| **CLD2** | Google, Inc. | Apache-2.0 | [@CLD2Owners/cld2](https://github.com/CLD2Owners/cld2) | [link](./README_CLD2.md) |
| **CLD3** | Google, Inc. | Apache-2.0 | [@google/cld3](https://github.com/google/cld3) | [link](./README_CLD3.md) |
| **FastText** | Meta Platforms, Inc. | MIT | [@facebookresearch/fastText](https://github.com/facebookresearch/fastText) | [link](./README_FASTTEXT.md) |
| **Whatlang** | Serhii Potapov | MIT | [@greyblake/whatlang-rs](https://github.com/greyblake/whatlang-rs) | [link](./README_WHATLANG.md) |
| **MediaPipe** | Google, Inc. | Apache-2.0 | [@google-ai-edge/mediapipe](https://github.com/google-ai-edge/mediapipe) | [link](./README_MEDIAPIPE.md) |
| **Lingua** | Peter M. Stahl | Apache-2.0 | [@pemistahl/lingua-rs](https://github.com/pemistahl/lingua-rs) | [link](./README_LINGUA.md) |
## Key concerns
- Zero-dependency development.
- The original code of libraries (CLD2, CLD3, FastText, MediaPipe) is used as submodules without additional significant modifications or improvements (except for a small monkey-patching π). Third-party code is not included into this repository.
- Preserve the original library behavior without breaking changes.
## Features
| Feature | CLD2 | CLD3 | FastText* | Whatlang | MediaPipe** | Lingua |
| :----------------------------- | :-------: | :------------: | :----------------: | :------: | :------------: | :------: |
| **Single language prediction** | Yes | Yes | Yes | Yes | Yes | Yes |
| **Multi language prediction** | Yes | Yes | Yes | No | Yes | Yes |
| **Supported languages** | 83 | 107 | 176 or 217 | 69 | 110 | 75 |
| **Unknown language detection** | Yes | Yes | No | No | Yes | No |
| **Algorithm** | quadgrams | neural network | neural network | trigrams | neural network | trigrams |
| **Script detection** | No | No | Yes (only lid218e) | Yes | No | No |
| **Written in** | C++ | C++ | C++ | Rust | C++ | Rust |
\* When using these models:
[lid176](https://fasttext.cc/docs/en/language-identification.html),
[lid218e](https://huggingface.co/facebook/fasttext-language-identification)
\*\* When using [MediaPipe Language Detector](https://storage.googleapis.com/mediapipe-assets/LanguageDetector%20Model%20Card.pdf)
## Platform support
| Model | Linux | Windows | macOS |
| :------------ | :----------------: | :----------------: | :----------------: |
| **CLD2** | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| **CLD3** | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| **FastText** | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| **Whatlang** | :white_check_mark: | :white_check_mark: | :white_check_mark: |
| **MediaPipe** | :white_check_mark: | :white_check_mark: | :white_check_mark:\* |
| **Lingua** | :white_check_mark: | :white_check_mark: | :white_check_mark:\* |
:white_check_mark: β Full support |
:x: β No support |
:construction: β Under research
\* **arm64** CPU only (Apple silicon M series)
## Contributing
We welcome contributions from developers of all skill levels. Whether you're fixing a bug, adding a new feature, or improving documentation, we appreciate your help in making this project better.
### Getting Started
To get started with contributing, follow these simple steps:
1. **Clone the Repository**
First, clone the repository to your local machine with the following command:
```bash
git clone --recurse-submodules --remote-submodules https://github.com/gluschenko/panlingo.git
```
2. **Create a Branch**
Before you start making changes, create a new branch to keep your work organized. Use a descriptive name for your branch to make it easy to understand its purpose:
```bash
git checkout -b feature/your-feature-name
```
3. **Make Changes**
Now, you can make changes to the codebase. Please ensure your code follows our project's coding standards and includes relevant tests if applicable.
4. **Commit Your Changes**
Once you've made your changes, commit them with a clear and informative commit message:
```bash
git add .
git commit -m "Add description of your changes"
```
5. **Push Your Changes**
Push your branch to the remote repository:
```bash
git push origin feature/your-feature-name
```
6. **Build**
Each library project in the solution has four configurations: `ReleaseLinuxOnly`, `DebugLinuxOnly`, `Release`, and `Debug`.
- The `ReleaseLinuxOnly` and `DebugLinuxOnly` configurations are for building on a local Linux or Windows machine (WSL is supported as well). It produces native binaries only for Linux.
- The `Release` and `Debug` configurations are intended for cross-platform builds, which are only supported in CI/CD environments like GitHub Actions.
Here's how you can build the projects on a local Linux machine.
**Requirements:**
- Windows 10 or higher.
- [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) set up for simulating a Linux environment.
- [Docker Desktop](https://www.docker.com/products/docker-desktop/) for container management.
- 45GB of free disk space for storing Docker images.
- Modern CPU with AVX support for optimal performance.
**To build the entire solution:**
```bash
cd src
dotnet build -c ReleaseLinuxOnly
```
**To build a specific library:**
```bash
cd src/LanguageIdentification.FastText.Native
dotnet build -c ReleaseLinuxOnly
cd src/LanguageIdentification.FastText
dotnet build -c ReleaseLinuxOnly
```
7. **Run**
Here's how you can run the test project on both Linux and Windows.
**Linux:**
To run the test project on a Linux machine, navigate to the test project's directory and use the following command:
```bash
cd src/LanguageIdentification.FastText.ConsoleTest
dotnet run -c ReleaseLinuxOnly
```
**Windows:**
If you're on a Windows machine, you can still run the test project using WSL. Follow these steps:
```bash
cd src/LanguageIdentification.FastText.ConsoleTest
wsl -d Ubuntu -e bash -c "dotnet run -c ReleaseLinuxOnly"
```
8. **Open a Pull Request**
Navigate to the repository on GitHub and open a pull request. Provide a detailed description of your changes and any additional information that might help reviewers understand your contribution.
### Review Process
After opening a pull request, it will be reviewed by one of the project maintainers. Feedback and suggestions might be provided to ensure the code meets our quality standards. Once approved, your changes will be merged into the main branch.
### Code of Conduct
Please note that this project adheres to a [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
## License
This project is licensed under the [MIT License](./LICENSE) Β© 2024β2025 Alexander Gluschenko.
Includes software from the following project(s):
- [CLD2](https://github.com/CLD2Owners/cld2) β Β© 2013 Google Inc., licensed under Apache-2.0
- [CLD3](https://github.com/google/cld3) β Β© 2016 Google Inc., licensed under Apache-2.0
- [FastText](https://github.com/facebookresearch/fastText) β Β© 2016βpresent Meta Platforms, Inc., licensed under MIT
- [Lingua](https://github.com/pemistahl/lingua-rs) β Β© 2020β2023 Peter M. Stahl, licensed under Apache-2.0
- [MediaPipe Language Detector](https://github.com/google-ai-edge/mediapipe) β Β© 2023β2025 Google Inc., licensed under Apache-2.0
- [Whatlang](https://github.com/greyblake/whatlang-rs) β Β© 2017 Serhii Potapov and others, licensed under MIT
See the [LICENSE](./LICENSE) file for full details.
---
Happy hacking! π©βπ»π¨βπ»