gsMap


Version		Status
Activity		Quality
CI/CD		Community
Downloads		License
Platform		Contribute

Introduction

gsMap (genetically informed spatial mapping of cells for complex traits) integrates spatial transcriptomics (ST) data with genome-wide association study (GWAS) summary statistics to map cells to human complex traits, including diseases, in a spatially resolved manner.

Key Features

Spatially-aware High-Resolution Trait Mapping
Spatial Region Identification
Putative Causal Genes Identification

Model Architecture

🛠️ Installation

Install using pip:

conda create -n gsMap python>=3.10
conda activate gsMap
pip install gsMap

Install using conda:

conda create -n gsMap python>=3.10
conda activate gsMap
conda install bioconda::gsmap

Install from source:

git clone https://github.com/JianYang-Lab/gsMap
cd gsMap
pip install -e .

Verify the installation by running the following command:

gsmap --help

🤖 AI-assisted Analysis

gsMap supports AI-assisted workflows that allow users to run spatial GWAS analysis using modern AI coding agents and Vibe coding environments. To add the gsMap MCP server and SKILLs in Claude Code:

cd gsMap/gsmap_vibe
uv pip install -e .
claude mcp add gsmap -- python -m gsmap_mcp
cp -r gsmap_skill ~/.claude/skills/

📘 Usage

Please check out the documentation and tutorials at gsMap Documentation.

🌐 Online Visualization

To visualize the traits-cell association spatial maps, please refer to gsMap Visualization.

📖 Citation

Song, L., Chen, W., Hou, J., Guo, M. & Yang, J. Spatially resolved mapping of cells associated with human complex traits. Nature (2025).

Please cite the paper and give us a STAR if you find gsMap useful for your research.

✨ Research Highlight

gsMap was highlighted in Nature Methods.
gsMap was highlighted in Nature Review Genetics.

Development Status
- 3 - Alpha
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- POSIX :: Linux
Programming Language

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gsmap-1.73.8.tar.gz (71.9 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gsmap-1.73.8-py3-none-any.whl (78.2 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file gsmap-1.73.8.tar.gz.

File metadata

Download URL: gsmap-1.73.8.tar.gz
Upload date: Aug 19, 2026
Size: 71.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for gsmap-1.73.8.tar.gz
Algorithm	Hash digest
SHA256	`e883edb41719276da8472c3fa84d0cd4a70b3a6e5524598d47293a13f087ee8d`
MD5	`f167f79f6a7e233c3a04e9548f58f06e`
BLAKE2b-256	`1b6f4ccb95823b7ba81f4952a205e9faa5ddbf87d6f343ac812f5e1bf06bd325`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gsmap-1.73.8.tar.gz:

Publisher: release.yml on JianYang-Lab/gsMap

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gsmap-1.73.8.tar.gz
- Subject digest: e883edb41719276da8472c3fa84d0cd4a70b3a6e5524598d47293a13f087ee8d
- Sigstore transparency entry: 2515260699
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: JianYang-Lab/gsMap@7fbdcf80cb3e35a341cf1a955bb4809f3e5e6e02
- Branch / Tag: refs/tags/v1.73.8
- Owner: https://github.com/JianYang-Lab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@7fbdcf80cb3e35a341cf1a955bb4809f3e5e6e02
- Trigger Event: push