<p align="center">
<a href="https://github.com/MAIF/melusine/actions?branch=master" target="_blank">
<img src="https://github.com/MAIF/melusine/actions/workflows/main.yml/badge.svg?branch=master" alt="Build & Test">
</a>
<a href="https://pypi.python.org/pypi/melusine" target="_blank">
<img src="https://img.shields.io/pypi/v/melusine.svg" alt="pypi">
</a>
<a href="https://opensource.org/licenses/Apache-2.0" target="_blank">
<img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Test">
</a>
<a href="https://shields.io/" target="_blank">
<img src="https://img.shields.io/badge/python-3.8+-blue.svg" alt="pypi">
</a>
</p>
<p align="center">🎉 **BREAKING** : New major version <b>Melusine 3.0</b> is available 🎉</p>
<p align="center">
<a href="https://maif.github.io/melusine" target="_blank">
<img src="docs/_static/melusine.png">
</a>
</p>
- **Free software**: Apache Software License 2.0
- **Documentation**: [maif.github.io/melusine](https://maif.github.io/melusine/)
- **Installation**: `pip install melusine`
- **Tutorials**: [Discover melusine](https://maif.github.io/melusine/tutorials/00_GettingStarted/)
## Overview
Discover Melusine, a comprehensive email processing library
designed to optimize your email workflow.
Leverage Melusine's advanced features to achieve:
- **Effortless Email Routing**: Ensure emails reach their intended destinations with high accuracy.
- **Smart Prioritization**: Prioritize urgent emails for timely handling and efficient task management.
- **Snippet Summaries**: Extract relevant information from lengthy emails, saving you precious time and effort.
- **Precision Filtering**: Eliminate unwanted emails from your inbox, maintaining focus and reducing clutter.
Melusine facilitates the integration of deep learning frameworks (HuggingFace, Pytorch, Tensorflow, etc),
deterministic rules (regex, keywords, heuristics) into a full email qualification workflow.
## Why Choose Melusine ?
Melusine stands out with its combination of features and advantages:
- **Pre-packaged Tools** : Melusine comes with out-of-the-box features such as
- Segmenting an email conversation into individual messages
- Tagging message parts (Email body, signatures, footers, etc)
- Transferred email handling
- **Streamlined Execution** : Focus on the core email qualification logic
while Melusine handles the boilerplate code, providing debug mode, pipeline execution, code parallelization, and more.
- **Flexible Integrations** : Melusine's modular architecture enables seamless integration with various AI frameworks,
ensuring compatibility with your preferred tools.
- **Production ready** : Proven in the MAIF production environment,
Melusine provides the robustness and stability you need.
## Email Segmentation Exemple
In the following example, an email is divided into two distinct messages
separated by a transition pattern.
Each message is then tagged line by line.
This email segmentation can later be leveraged to enhance the performance of machine learning models.
<p align="center">
<a href="https://maif.github.io/melusine" target="_blank">
<img src="docs/_static/segmentation.png">
</a>
</p>
## Getting started
Explore our comprehensive [documentation](https://maif.github.io/melusine/) and tested [tutorials](https://maif.github.io/melusine/tutorials/00_GettingStarted/) to get started.
Or dive into our minimal example to experience Melusine's simplicity and power:
``` Python
from melusine.data import load_email_data
from melusine.pipeline import MelusinePipeline
# Load an email dataset
df = load_email_data()
# Load a pipeline
pipeline = MelusinePipeline.from_config("demo_pipeline")
# Run the pipeline
df = pipeline.transform(df)
```
The code above executes a default pipeline and returns a qualified email dataset with columns such as:
- `messages`: List of individual messages present in each email.
- `emergency_result`: Flag to identify urgent emails.
With Melusine, you're well-equipped to transform your email handling, streamlining processes, maximizing efficiency,
and enhancing overall productivity.
Raw data
{
"_id": null,
"home_page": null,
"name": "melusine",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "nlp, email, courriel, text, data-science, machine-learning, natural-language-processing",
"author": "Tiphaine Fabre, Sacha Samama, Antoine Simoulin",
"author_email": "Hugo Perrier <hugorperrier@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/55/56/02620294d1a577081d86e53f8932f3166a20c95d1fa59c4727a7f08235c1/melusine-3.2.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n<a href=\"https://github.com/MAIF/melusine/actions?branch=master\" target=\"_blank\">\n<img src=\"https://github.com/MAIF/melusine/actions/workflows/main.yml/badge.svg?branch=master\" alt=\"Build & Test\">\n</a>\n<a href=\"https://pypi.python.org/pypi/melusine\" target=\"_blank\">\n<img src=\"https://img.shields.io/pypi/v/melusine.svg\" alt=\"pypi\">\n</a>\n<a href=\"https://opensource.org/licenses/Apache-2.0\" target=\"_blank\">\n<img src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"Test\">\n</a>\n<a href=\"https://shields.io/\" target=\"_blank\">\n<img src=\"https://img.shields.io/badge/python-3.8+-blue.svg\" alt=\"pypi\">\n</a>\n</p>\n\n<p align=\"center\">\ud83c\udf89 **BREAKING** : New major version <b>Melusine 3.0</b> is available \ud83c\udf89</p>\n\n<p align=\"center\">\n<a href=\"https://maif.github.io/melusine\" target=\"_blank\">\n<img src=\"docs/_static/melusine.png\">\n</a>\n</p>\n\n- **Free software**: Apache Software License 2.0\n- **Documentation**: [maif.github.io/melusine](https://maif.github.io/melusine/)\n- **Installation**: `pip install melusine`\n- **Tutorials**: [Discover melusine](https://maif.github.io/melusine/tutorials/00_GettingStarted/)\n\n## Overview\n\nDiscover Melusine, a comprehensive email processing library\ndesigned to optimize your email workflow.\nLeverage Melusine's advanced features to achieve:\n\n- **Effortless Email Routing**: Ensure emails reach their intended destinations with high accuracy.\n- **Smart Prioritization**: Prioritize urgent emails for timely handling and efficient task management.\n- **Snippet Summaries**: Extract relevant information from lengthy emails, saving you precious time and effort.\n- **Precision Filtering**: Eliminate unwanted emails from your inbox, maintaining focus and reducing clutter.\n\nMelusine facilitates the integration of deep learning frameworks (HuggingFace, Pytorch, Tensorflow, etc),\ndeterministic rules (regex, keywords, heuristics) into a full email qualification workflow.\n\n## Why Choose Melusine ?\n\nMelusine stands out with its combination of features and advantages:\n\n- **Pre-packaged Tools** : Melusine comes with out-of-the-box features such as\n - Segmenting an email conversation into individual messages\n - Tagging message parts (Email body, signatures, footers, etc)\n - Transferred email handling\n- **Streamlined Execution** : Focus on the core email qualification logic\nwhile Melusine handles the boilerplate code, providing debug mode, pipeline execution, code parallelization, and more.\n- **Flexible Integrations** : Melusine's modular architecture enables seamless integration with various AI frameworks,\nensuring compatibility with your preferred tools.\n- **Production ready** : Proven in the MAIF production environment,\nMelusine provides the robustness and stability you need.\n\n## Email Segmentation Exemple\n\nIn the following example, an email is divided into two distinct messages\nseparated by a transition pattern.\nEach message is then tagged line by line.\nThis email segmentation can later be leveraged to enhance the performance of machine learning models.\n\n<p align=\"center\">\n<a href=\"https://maif.github.io/melusine\" target=\"_blank\">\n<img src=\"docs/_static/segmentation.png\">\n</a>\n</p>\n\n## Getting started\n\nExplore our comprehensive [documentation](https://maif.github.io/melusine/) and tested [tutorials](https://maif.github.io/melusine/tutorials/00_GettingStarted/) to get started.\nOr dive into our minimal example to experience Melusine's simplicity and power:\n\n``` Python\n from melusine.data import load_email_data\n from melusine.pipeline import MelusinePipeline\n\n # Load an email dataset\n df = load_email_data()\n\n # Load a pipeline\n pipeline = MelusinePipeline.from_config(\"demo_pipeline\")\n\n # Run the pipeline\n df = pipeline.transform(df)\n```\n\nThe code above executes a default pipeline and returns a qualified email dataset with columns such as:\n- `messages`: List of individual messages present in each email.\n- `emergency_result`: Flag to identify urgent emails.\n\n\nWith Melusine, you're well-equipped to transform your email handling, streamlining processes, maximizing efficiency,\nand enhancing overall productivity.\n",
"bugtrack_url": null,
"license": "Apache Software License 2.0",
"summary": "Melusine is a high-level library for emails processing",
"version": "3.2.0",
"project_urls": null,
"split_keywords": [
"nlp",
" email",
" courriel",
" text",
" data-science",
" machine-learning",
" natural-language-processing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5b073272dc66773ff11c016888742d174c4e83cab131ddf10a69592252c9767b",
"md5": "2be6a2c75bf80886d31cd089ade4c272",
"sha256": "22768baef37d08307956e7ae29f8dad78793a24e83c66805726219a9e19f108b"
},
"downloads": -1,
"filename": "melusine-3.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2be6a2c75bf80886d31cd089ade4c272",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 304835,
"upload_time": "2025-01-23T08:39:20",
"upload_time_iso_8601": "2025-01-23T08:39:20.856664Z",
"url": "https://files.pythonhosted.org/packages/5b/07/3272dc66773ff11c016888742d174c4e83cab131ddf10a69592252c9767b/melusine-3.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "555602620294d1a577081d86e53f8932f3166a20c95d1fa59c4727a7f08235c1",
"md5": "359e4212e22c6216d5c180ffd2c9038c",
"sha256": "55e3806bbfb3ad3b5ee6e4fbc19ff743f638659cfffe189e586ad4155e8ee753"
},
"downloads": -1,
"filename": "melusine-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "359e4212e22c6216d5c180ffd2c9038c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 277548,
"upload_time": "2025-01-23T08:39:22",
"upload_time_iso_8601": "2025-01-23T08:39:22.236505Z",
"url": "https://files.pythonhosted.org/packages/55/56/02620294d1a577081d86e53f8932f3166a20c95d1fa59c4727a7f08235c1/melusine-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-23 08:39:22",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "melusine"
}
JSON