Metadata-Version: 2.1
Name: mcl_name_comparison
Version: 1.0.0
Summary: A Python software by Metacode Linguistics that provides name comparison scores
Author: Metacode Linguistics
Author-email: info@aitechs.in
License: ## End User License Agreement (EULA) for mcl_name_comparison by Metacode Linguistics
        
        ### 1. Introduction
        
        This End User License Agreement ("EULA") is a legal agreement between you (either an individual or a single entity) and Metacode Linguistics ("Licensor") for the use of the mcl_name_comparison software ("Software"). By installing, copying, or otherwise using the Software, you agree to be bound by the terms of this EULA. If you do not agree to the terms of this EULA, do not install or use the Software.
        
        ### 2. Grant of License
        
        Subject to the terms and conditions of this EULA, Licensor hereby grants you a limited, non-exclusive, non-transferable license to install and use the Software on a single edge device for your internal business purposes only. This license does not allow you to:
        
        1. Distribute the Software to any third party.
        2. Use the Software for any illegal purpose.
        3. Modify, adapt, translate, or create derivative works based upon the Software.
        4. Reverse engineer, decompile, or disassemble the Software.
        5. Use the Software in a manner not expressly authorized by this EULA.
        
        ### 3. Intellectual Property Rights
        
        The Software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. All title and intellectual property rights in and to the Software are owned by Licensor. This EULA does not grant you any rights to trademarks or service marks of Licensor.
        
        ### 4. Restrictions
        
        You agree not to use the Software in any manner that could damage, disable, overburden, or impair the Software or any service provided by Licensor. You shall not attempt to gain unauthorized access to any accounts, computer systems, or networks connected to the Software.
        
        ### 5. Termination
        
        This EULA is effective until terminated. Your rights under this EULA will terminate automatically without notice from Licensor if you fail to comply with any term(s) of this EULA. Upon termination, you must immediately cease all use of the Software and destroy all copies of the Software.
        
        ### 6. Disclaimer of Warranties
        
        The Software is provided "AS IS" and "AS AVAILABLE" without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. Licensor does not warrant that the Software will meet your requirements, achieve any intended results, be compatible or work with any other software, systems or services, be error-free, or that any errors or defects can or will be corrected.
        
        ### 7. Limitation of Liability
        
        In no event shall Licensor be liable for any damages (including, without limitation, lost profits, business interruption, or lost information) arising out of your use of or inability to use the Software, even if Licensor has been advised of the possibility of such damages. In no event will Licensor be liable for loss of data or for indirect, special, incidental, consequential (including lost profit), or other damages based in contract, tort, or otherwise. Licensor shall have no liability with respect to the content of the Software or any part thereof, including but not limited to errors or omissions contained therein, libel, infringements of rights of publicity, privacy, trademark rights, business interruption, personal injury, loss of privacy, moral rights, or the disclosure of confidential information.
        
        ### 8. Indemnification
        
        You agree to indemnify, defend, and hold harmless Licensor, its officers, directors, employees, and agents from and against any claims, liabilities, damages, losses, costs, expenses, or fees (including reasonable attorneys' fees) arising from your use of the Software or your violation of this EULA.
        
        ### 9. Governing Law
        
        This EULA shall be governed by and construed in accordance with the laws of the jurisdiction in which Licensor is located, without regard to its conflict of law principles. You agree to submit to the personal and exclusive jurisdiction of the courts located in the jurisdiction in which Licensor is located.
        
        ### 10. Entire Agreement
        
        This EULA constitutes the entire agreement between you and Licensor regarding the use of the Software and supersedes all prior and contemporaneous understandings, agreements, representations, and warranties, whether oral or written, regarding such subject matter.
        
        ### 11. Amendments
        
        Licensor reserves the right to modify this EULA at any time by providing notice to you. Your continued use of the Software following such notice will be deemed acceptance of any such modifications.
        
        ### 12. Contact Information
        
        If you have any questions about this EULA, please contact Metacode Linguistics at:
        
        Metacode Linguistics
        Email: info@aitechs.in
        
        By installing and using the Software, you acknowledge that you have read and understand this EULA and agree to be bound by its terms and conditions.
License-File: LICENSE.txt
Requires-Dist: toml ==0.10.2
Requires-Dist: sentence-transformers ==2.7.0

### Name Comparison

When it comes to background verification and profile matching, understanding the dedicated name embeddings can significantly enhance the process. Here's how:

1. Capturing Latent Information: Name embeddings are representations of names in a high-dimensional vector space where similar names are closer together and dissimilar names are farther apart. These embeddings are generated through advanced machine learning techniques, such as deep learning models. By utilizing name embeddings, we can capture latent information embedded within names that might not be apparent through traditional methods.

2. Semantic Similarity: Name embeddings allow us to measure the semantic similarity between names. Names that are similar in meaning or pronunciation will have closer embeddings. This enables more accurate matching of names that may have different spellings or variations but represent the same individual. For example, variations like "Jon" and "John" would have embeddings that are close together, indicating their semantic similarity.

3. Cross-lingual Compatibility: Name embeddings can transcend language barriers. They are not limited to a specific language or alphabet. This cross-lingual compatibility is particularly useful in diverse environments where names from various linguistic backgrounds are encountered. It enables seamless matching across different languages and scripts, enhancing the inclusivity and effectiveness of the verification process.

4. Handling Cultural Variations: Names often exhibit cultural variations and may have different spellings or structures across regions and ethnicities. Name embeddings can encapsulate these variations and still recognize the underlying similarity between names. This capability is invaluable in handling diverse datasets and ensuring accurate profile matching regardless of cultural or regional differences.

5. Robustness to Noise: Background verification datasets may contain noisy or incomplete information. Name embeddings offer robustness to such noise by focusing on the underlying semantic structure of names rather than relying solely on exact matches. This improves the resilience of the matching process, reducing the likelihood of false negatives or missed connections.

6. Scalability and Efficiency: With advancements in deep learning techniques, generating name embeddings has become computationally efficient, allowing for scalable implementation in large-scale verification systems. This scalability enables rapid processing of vast amounts of data, facilitating timely and accurate profile matching.

In summary, leveraging dedicated name embeddings in background verification enhances the process by capturing latent information within names, facilitating semantic similarity measurement, ensuring cross-lingual compatibility, handling cultural variations, improving robustness to noise, and enabling scalability and efficiency. By incorporating these advanced techniques, profile matching becomes more accurate, comprehensive, and reliable, ultimately enhancing the overall effectiveness of background verification systems.

How to use:

**Cretae a vitual environment**

`conda create -n "name_similarity" python=3.10`



**Install the wheel file**
`pip install --force-reinstall <path to name_comparison whl file>`

**Import modult to perform name comparison**
`from mcl_name_comparison import NameComparison`
`scorer = NameComparison(token = "<secret token>")`
`print(name_compare.get_comparison("Jesus", "Chewy")) # ~0.796`
