Skip to content
Back to search

dynamo-release

Inclusive model of expression dynamics with conventional or metabolic labeling based scRNA-seq / multiomics, vector field reconstruction and differential geometry analyses

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aristoteleo/dynamo-release with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aristoteleo/dynamo-release'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aristoteleo--dynamo-release/badge.svg)](/listings/aristoteleo--dynamo-release)

HTML

<a href="/listings/aristoteleo--dynamo-release"><img src="/api/listings/aristoteleo--dynamo-release/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img height="150" src="https://dynamo-release.readthedocs.io/en/latest/_static/logo.png" />
  3. </p>
  4. ##
  5. <!--
  6. [![package](https://github.com/aristoteleo/dynamo-release/workflows/Python%20package/badge.svg)](https://github.com/aristoteleo/dynamo-release)/!>
  7. -->
  8. [![upload](https://img.shields.io/pypi/v/dynamo-release?logo=PyPI)](https://pypi.org/project/dynamo-release/)
  9. [![conda](https://img.shields.io/conda/vn/conda-forge/dynamo-release.svg)](https://anaconda.org/conda-forge/dynamo-release)
  10. [![download](https://static.pepy.tech/badge/dynamo-release)](https://pepy.tech/project/dynamo-release)
  11. [![star](https://img.shields.io/github/stars/aristoteleo/dynamo-release?logo=GitHub&color=red)](https://github.com/aristoteleo/dynamo-release/stargazers)
  12. [![build](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-package.yml/badge.svg)](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-package.yml)
  13. [![documentation](https://readthedocs.org/projects/dynamo-release/badge/?version=latest)](https://dynamo-release.readthedocs.io/en/latest/)
  14. [![upload_python_package](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-publish.yml/badge.svg)](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-publish.yml)
  15. [![test](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-plain-run-test.yml/badge.svg)](https://github.com/aristoteleo/dynamo-release/actions/workflows/python-plain-run-test.yml)
  16. ## **Dynamo**: Mapping Transcriptomic Vector Fields of Single Cells
  17. Inclusive model of expression dynamics with metabolic labeling based scRNA-seq / multiomics, vector field reconstruction, potential landscape mapping, differential geometry analyses, and most probably paths / *in silico* perturbation predictions.
  18. [Installation](https://dynamo-release.readthedocs.io/en/latest/installation.html) - [Ten minutes to dynamo](https://dynamo-release.readthedocs.io/en/latest/user_guide/index.html) - [Tutorials](https://dynamo-release.readthedocs.io/en/latest/tutorials/index.html) - [API](https://dynamo-release.readthedocs.io/en/latest/api/index.html) - [Citation](https://dynamo-release.readthedocs.io/en/latest/references.html) - [Theory](https://dynamo-release.readthedocs.io/en/latest/introduction/index.html) - [Protocol](https://doi.org/10.1038/s41596-026-01458-3)
  19. > **New:** the step-by-step dynamo protocol is now published in *Nature Protocols*: [Predictive modeling of single-cell transcriptomic dynamics with Dynamo](https://doi.org/10.1038/s41596-026-01458-3). It walks through nine reproducible case studies, from velocity estimation to *in silico* perturbation and least action paths. See [The dynamo protocol](#the-dynamo-protocol) below.
  20. ![Dynamo](https://user-images.githubusercontent.com/7456281/152110270-7ee1b0ed-1205-495d-9d65-59c7984d2fa2.png)
  21. Single-cell (sc)RNA-seq, together with RNA velocity and metabolic labeling, reveals cellular states and transitions at unprecedented resolution. Fully exploiting these data, however, requires kinetic models capable of unveiling governing regulatory functions. Here, we introduce an analytical framework dynamo, which infers absolute RNA velocity, reconstructs continuous vector fields that predict cell fates, employs differential geometry to extract underlying regulations, and ultimately predicts optimal reprogramming paths and perturbation outcomes. We highlight dynamo’s power to overcome fundamental limitations of conventional splicing-based RNA velocity analyses to enable accurate velocity estimations on a metabolically labeled human hematopoiesis scRNA-seq dataset. Furthermore, differential geometry analyses reveal mechanisms driving early megakaryocyte appearance and elucidate asymmetrical regulation within the PU.1-GATA1 circuit. Leveraging the least-action-path method, dynamo accurately predicts drivers of numerous hematopoietic transitions. Finally, in silico perturbations predict cell-fate diversions induced by gene perturbations. Dynamo, thus, represents an important step in advancing quantitative and predictive theories of cell-state transitions.
  22. ## Highlights of dynamo
  23. * Robust and accurate estimation of RNA velocities for regular scRNA-seq datasets:
  24. * Three methods for the velocity estimations (including the new negative binomial distribution based approach)
  25. * Improved kernels for transition matrix calculation and velocity projection
  26. * Strategies to correct RNA velocity vectors (when your RNA velocity direction is problematic)
  27. * Inclusive modeling of time-resolved metabolic labeling based scRNA-seq:
  28. * Overcome intrinsic limitation of the conventional splicing based RNA velocity analyses
  29. * Explicitly model RNA metabolic labeling, in conjunction with RNA bursting, transcription, splicing and degradation
  30. * Comprehensive RNA kinetic rate estimation for one-shot, pulse, chase and mixture metabolic labeling experiments
  31. * Move beyond RNA velocity to continuous vector field function for gaining mechanistic insights into cell fate transitions:
  32. * Dynamical systems approaches to identify stable cell types (fixed points), boundaries of cell states (separatrices), etc
  33. * Calculate RNA acceleration (reveals early drivers), curvature (reveals master regulators of fate decision points), divergence (stability of cell states) and RNA Jacobian (cell-state dependent regulatory networks)
  34. * Various downstream differential geometry analyses to rank critical regulators/effectors, and visualize regulatory networks at key fate decision points
  35. * Non-trivial vector field predictions of cell fate transitions:
  36. * Least action path approach to predict the optimal paths and transcription factors of cell fate reprogramming
  37. * In silico perturbation to predict the gene-wise perturbation effects and cell fate diversion after genetic perturbations
  38. ## The dynamo protocol
  39. Our protocol, [Predictive modeling of single-cell transcriptomic dynamics with Dynamo](https://doi.org/10.1038/s41596-026-01458-3) (*Nature Protocols*, 2026), is a hands-on guide to building analytical vector fields from four kinds of single-cell data and to five downstream analyses. It is written for researchers with basic familiarity with scRNA-seq analysis and Python; the nine case studies can be completed in about seven and a half hours.
  40. | | Case study | Input data | What you learn |
  41. |---|---|---|---|
  42. | 1 | Standard workflow for metabolic labeling data | Human hematopoiesis scNT-seq (new / total RNA) | Absolute RNA velocity, vector field reconstruction, topography (attractors, saddles, repulsors), fate prediction |
  43. | 2 | Standard workflow for conventional scRNA-seq | Pancreatic endocrinogenesis (spliced / unspliced) | Preprocessing recipes, stochastic splicing kinetics, velocity confidence and correction, acceleration and curvature |
  44. | 3 | Vector field from pseudotime or other scalars | Any dataset with pseudotime or a differentiation score | `pseudotime_velocity`, transition graphs, topography without splicing or labeling |
  45. | 4 | Velocity for single-cell multiomics | Paired scRNA-seq + scATAC-seq | Multimodal preprocessing, chromatin-coupled velocity, transition gene selection |
  46. | 5 | Vector fields from external velocity tools | Velocities from CellDancer, DeepVelo, LatentVelo or veloVI | `dyn.tl.extvelo`, importing external velocities, topography on imported velocities |
  47. | 6 | Minimal network for basophil lineage commitment | Reconstructed hematopoiesis vector field | Jacobian calculation, regulatory ranking, network inference |
  48. | 7 | Cell-wise analyses of PU.1 (SPI1) and GATA1 | Reconstructed vector field and regulator-effector pairs | Gene-pair streamlines, Jacobian visualization, response heat maps |
  49. | 8 | *In silico* perturbation | Reconstructed hematopoiesis vector field | Single and combinatorial knockout / activation, fate diversion prediction |
  50. | 9 | Most probable path predictions | Reconstructed vector field with source and target states | Least action paths, transition categories, transcription factor ranking |
  51. * Tutorials that reproduce every case study: [dynamo-release.readthedocs.io](https://dynamo-release.readthedocs.io/en/latest/tutorials/index.html)
  52. * Code to reproduce the figures of the protocol: [aristoteleo/dynamo-protocol](https://github.com/aristoteleo/dynamo-protocol)
  53. * Web apps for least action paths and *in silico* perturbation: [lap_silico](https://aristoteleo.shinyapps.io/lap_silico) and [perturbation_silico](https://aristoteleo.shinyapps.io/perturbation_silico/)
  54. ## Citation
  55. If you use dynamo in your work, please cite:
  56. * Qiu, X. *et al.* Mapping transcriptomic vector fields of single cells. *Cell* **185**, 690–711.e45 (2022). [https://doi.org/10.1016/j.cell.2021.12.045](https://doi.org/10.1016/j.cell.2021.12.045)
  57. * Zeng, Z., Yu, S., Ni, K., Zhang, Y., Shin, U., Huang, C., Cao, N., Weissman, J., Ellison, D., Xing, J. & Qiu, X. Predictive modeling of single-cell transcriptomic dynamics with Dynamo. *Nature Protocols* (2026). [https://doi.org/10.1038/s41596-026-01458-3](https://doi.org/10.1038/s41596-026-01458-3)
  58. ## News
  59. * 11/16/2026: our dynamo protocol, with nine reproducible case studies, is online in [Nature Protocols](https://doi.org/10.1038/s41596-026-01458-3) today!
  60. * 5/30/2023: dynamo 1.3.0 released!
  61. * 3/1/2023: We welcome @Sichao25 to join the dynamo development team!
  62. * 1/28/2023: We welcome @Ukyeon to join the dynamo development team!
  63. * 15/12/2022: *Thanks for @elfofmaxwell and @MukundhMurthy's contribution*. dynamo 1.2.0 released
  64. * 11/11/2022: the continuing development of dynamo and the Aristotle ecosystem will be supported by CZI. See [here](https://chanzuckerberg.com/eoss/proposals/predictive-modeling-of-single-cell-multiomics-over-time-and-space/)
  65. * 4/14/2022: dynamo 1.1.0 released!
  66. * 3/14/2022: Since today dynamo has its own logo! Here the arrow represents the RNA velocity vector field, while the helix is the RNA molecule and the colored dots are RNA metabolic labels (4sU labeling). See [readthedocs](https://dynamo-release.readthedocs.io/en/latest/index.html)
  67. * 2/15/2022: primers and tutorials on least action paths and in silico perturbation are released.
  68. * 2/1/2022: after 3.5+ years of perseverance, our dynamo paper is finally online in [Cell](https://www.sciencedirect.com/science/article/pii/S0092867421015774#tbl1) today!
  69. ## Discussion
  70. Please use github issue tracker to report coding related [issues](https://github.com/aristoteleo/dynamo-release/issues) of dynamo. For community discussion of novel usage cases, analysis tips and biological interpretations of dynamo, please join our public slack workspace: [dynamo-discussion](https://join.slack.com/t/dynamo-discussionhq/shared_invite/zt-itnzjdxs-PV~C3Hr9uOArHZcmv622Kg) (Only a working email address is required from the slack side).
  71. ## Contribution
  72. If you want to contribute to the development of dynamo, please check out CONTRIBUTION instruction: [Contribution](https://github.com/aristoteleo/dynamo-release/blob/master/CONTRIBUTING.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.