# MetaChat
## Brief introduction
MetaChat is a Python package to screen metabolic cell communication (MCC) from spatial multi-omics data of transcriptomics and metabolomics.
It contains many intuitive visualization and downstream analysis tools, provides a great practical toolbox for biomedical researchers.
### Metabolic cell communication
Metabolic cell-cell communication (MCC) occurs when sensor proteins in the receiver cells detect metabolites in their environment, activating intracellular signaling events. There are three major potential sensors of metabolites: surface receptors, nuclear receptors, and transporters. Metabolites secreted from cells are either transported over short-range distances (a few cells) via diffusion through extracellular space, or over long-range distances via the bloodstream and the cerebrospinal fluid (CSF).
<img width="600" alt="image" src="https://github.com/SonghaoLuo/MetaChat/assets/138028157/f08f21de-eeae-4626-8fbe-c26a307ec225">
### MetaChatDB
MetaChatDB is a literature-supported database for metabolite-sensor interactions for both human and mouse. All the metabolite-sensor interactions are reported based on peer-reviewed publications. Specifically, we manually build MetaChatDB by integrating three high-quality databases (PDB, HMDB, UniProt) that are being continually updated.
<img width="700" alt="image2" src="https://github.com/user-attachments/assets/1601f7f1-0997-4bdf-96da-5d2ae1fd28a2" />
### Documentation, and Tutorials
For more basic tutorial and real data examples, please see MetaChat documentation that is available through the link https://metachat.readthedocs.io/en/latest/.
### Analysis pipeline
<img width="2000" height="7914" alt="Table2" src="https://github.com/user-attachments/assets/d018be0e-fad2-4c74-b91e-4c0d929851c1" />
## Installation
### System requirements
Recommended operating systems: macOS or Linux. MetaChat was developed and tested on Linux and macOS.
### Python requirements
MetaChat was developed using python 3.9.
### Installation using `pip`
We suggest setting up MetaChat in a separate `mamba` or `conda` environment to prevent conflicts with other software dependencies. Create a new Python environment specifically for MetaChat and install the required libraries within it.
```bash
mamba create -n metachat_env python=3.9 r-base=4.3.2
mamba activate metachat_env
pip install metachat
```
if you use `conda`, `r-base=4.3.2` may not included in the channels. Instead, you can `r-base=4.3.1` in `conda`.
## Reference
Luo S., Almet A.A., Zhao W., He C., Tsai Y.-C., Ozaki H., Sugita B.K., Du K., Shen X., Cao Y., Yang Q., Watanabe M., Nie Q.* Spatial metabolic communication flow of cells.
Raw data
{
"_id": null,
"home_page": "https://https://github.com/SonghaoLuo/metachat",
"name": "metachat",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "metabolic cell communicaiton, spatial transcriptomics, spatial metabolomics, optimal transport",
"author": "Songhao Luo",
"author_email": "songhal2@@uci.edu",
"download_url": "https://files.pythonhosted.org/packages/38/51/ef07b32edae5ad257c93a7f90967867eb993084b13fd245253836a822f25/metachat-0.0.6.tar.gz",
"platform": null,
"description": "# MetaChat\n## Brief introduction\nMetaChat is a Python package to screen metabolic cell communication (MCC) from spatial multi-omics data of transcriptomics and metabolomics. \nIt contains many intuitive visualization and downstream analysis tools, provides a great practical toolbox for biomedical researchers.\n\n### Metabolic cell communication\nMetabolic cell-cell communication (MCC) occurs when sensor proteins in the receiver cells detect metabolites in their environment, activating intracellular signaling events. There are three major potential sensors of metabolites: surface receptors, nuclear receptors, and transporters. Metabolites secreted from cells are either transported over short-range distances (a few cells) via diffusion through extracellular space, or over long-range distances via the bloodstream and the cerebrospinal fluid (CSF).\n\n<img width=\"600\" alt=\"image\" src=\"https://github.com/SonghaoLuo/MetaChat/assets/138028157/f08f21de-eeae-4626-8fbe-c26a307ec225\">\n\n### MetaChatDB\nMetaChatDB is a literature-supported database for metabolite-sensor interactions for both human and mouse. All the metabolite-sensor interactions are reported based on peer-reviewed publications. Specifically, we manually build MetaChatDB by integrating three high-quality databases (PDB, HMDB, UniProt) that are being continually updated.\n\n<img width=\"700\" alt=\"image2\" src=\"https://github.com/user-attachments/assets/1601f7f1-0997-4bdf-96da-5d2ae1fd28a2\" />\n\n### Documentation, and Tutorials\nFor more basic tutorial and real data examples, please see MetaChat documentation that is available through the link https://metachat.readthedocs.io/en/latest/.\n\n### Analysis pipeline\n\n<img width=\"2000\" height=\"7914\" alt=\"Table2\" src=\"https://github.com/user-attachments/assets/d018be0e-fad2-4c74-b91e-4c0d929851c1\" />\n\n## Installation\n### System requirements\nRecommended operating systems: macOS or Linux. MetaChat was developed and tested on Linux and macOS.\n### Python requirements\nMetaChat was developed using python 3.9.\n### Installation using `pip`\nWe suggest setting up MetaChat in a separate `mamba` or `conda` environment to prevent conflicts with other software dependencies. Create a new Python environment specifically for MetaChat and install the required libraries within it.\n\n```bash\nmamba create -n metachat_env python=3.9 r-base=4.3.2\nmamba activate metachat_env\npip install metachat\n```\nif you use `conda`, `r-base=4.3.2` may not included in the channels. Instead, you can `r-base=4.3.1` in `conda`.\n\n\n\n## Reference\nLuo S., Almet A.A., Zhao W., He C., Tsai Y.-C., Ozaki H., Sugita B.K., Du K., Shen X., Cao Y., Yang Q., Watanabe M., Nie Q.* Spatial metabolic communication flow of cells.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Spatial metabolic communication flow of cells.",
"version": "0.0.6",
"project_urls": {
"Homepage": "https://https://github.com/SonghaoLuo/metachat"
},
"split_keywords": [
"metabolic cell communicaiton",
" spatial transcriptomics",
" spatial metabolomics",
" optimal transport"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7df7a969ed25aec0aed86303fd4a81ad80c7a5e08485d03c3e59ffd0fd4ee066",
"md5": "95c9b243ca892c52f4257f5c246be8e1",
"sha256": "80f570edeffaea8d98afeb1c37e8a60f36bdca688a36dc9a3e7ec2af8e12eee9"
},
"downloads": -1,
"filename": "metachat-0.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "95c9b243ca892c52f4257f5c246be8e1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 451812,
"upload_time": "2025-10-24T22:54:54",
"upload_time_iso_8601": "2025-10-24T22:54:54.317889Z",
"url": "https://files.pythonhosted.org/packages/7d/f7/a969ed25aec0aed86303fd4a81ad80c7a5e08485d03c3e59ffd0fd4ee066/metachat-0.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3851ef07b32edae5ad257c93a7f90967867eb993084b13fd245253836a822f25",
"md5": "7a3ba6aae659cecb7d63ca176a48c211",
"sha256": "3db2b1affb85dfaa7b2dbec5aabfa348b3e7483ed70c50d0ca018b18f1a5390e"
},
"downloads": -1,
"filename": "metachat-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "7a3ba6aae659cecb7d63ca176a48c211",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 68702,
"upload_time": "2025-10-24T22:54:55",
"upload_time_iso_8601": "2025-10-24T22:54:55.494110Z",
"url": "https://files.pythonhosted.org/packages/38/51/ef07b32edae5ad257c93a7f90967867eb993084b13fd245253836a822f25/metachat-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 22:54:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "metachat"
}