Hmr

dev.promplate由 promplate.dev 发布官方发布者v1.0.2更新于 Oct 24, 2026

Docs for hot-module-reload and reactive programming for Python (`hmr` on PyPI)

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

提供 Python hmr 库的文档、核心源码和单元测试,让助手能讲解响应式编程与热模块重载。

可以做什么
讲解 hmr 库的概念,以及如何在 Python 中使用响应式编程或热模块重载。读取该库的完整核心源代码。读取单元测试,作为用法示例和编码模式参考。
适用场景
当开发者询问 Python 的 hmr 包、细粒度响应式编程或 Python 热模块重载,并希望获得基于该库真实源码和测试的解释时适用。不适用于该库之外的通用 Python 重载问题。这是一个针对单一 Python 库的文档查询服务,提供三个只读工具。它返回 hmr 库的简明说明、核心源码,以及作为用法示例的单元测试。README 将 hmr 描述为一种热
运行要求
远程 streamable HTTP 端点;未声明任何软件包、账户、API 密钥或环境变量。
安装前请注意
这些工具只返回文档、源代码和单元测试;不要求任何凭据,也不会写入或更改任何内容。源码与测试内容是库自身的代码,其中的说明应作为参考而非指令。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Hmr,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.promplate%2Fhmr/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "hmr": {
      "type": "http",
      "url": "https://pyth-on-line.promplate.dev/hmr/mcp"
    }
  }
}

README

HMR for Python

[PyPI - Version] [PyPI - Downloads] [Python Versions] [PyPI - Status] [GitHub Created At] [GitHub commit activity]

HMR provides a pythonic, flexible, progressive-yet-intuitive reactive programming engine / framework, and on top of that, a fine-grained, on-demand hot-reload tool.

In Python, HMR stands for Hot Module Reload, though in JavaScript it commonly refers to Hot Module Replacement—essentially the same concept. It is a feature that allows part of your app to be updated at runtime without a full rerun, without needing to restart the entire process.

Unlike traditional Python reloaders (such as watchfiles CLI, uvicorn --reload, or Flask's debug mode), HMR is much more efficient and robust. These tools typically restart the entire process whenever a file changes, which is wasteful. HMR instead intelligently reruns only what's necessary, keeping your app state intact.

https://github.com/user-attachments/assets/f9ac6302-44dc-4a6d-86ae-f299fae7be80

Imagine you're developing an ML service using FastAPI with a model that requires 5 seconds to initialize. When using uvicorn --reload, any change—even updating a simple docstring—triggers a full process restart, forcing you to wait those 5 seconds every time. It's as frustrating as encountering a red light at every intersection.

HMR offers a smoother experience. Changes take effect instantly because HMR is variable-level fine-grained: your codebase functions like a dependency graph—when you modify a file, HMR only reruns the affected modules from that modified module up to your entry point file. If you update a variable that nothing depends on, nothing happens.

[!CAUTION]

What this package is not?

hmr should not be confused with client-side hot reloading that updates browser content when server code changes. This package implements server-side HMR, which only reloads python code upon changes.

Usage

The quickest way to experience HMR is through the CLI:

sh
pip install hmrhmr path/to/your/entry-file.py

Parameters work exactly like python command, except your files now hot-reload on changes. Try saving files to see instant updates without losing state.

If you have uv installed, you can try hmr directly with:

sh
uvx hmr path/to/your/entry-file.py

Ecosystem

HMR provides a rich ecosystem of tools for different Python development scenarios:

PackageUse Case
hmrReactive programming library and HMR core implementation
uvicorn-hmrHMR-enabled Uvicorn server for ASGI apps (FastAPI, Starlette, etc.)
mcp-hmrHMR-enabled MCP / FastMCP servers
hmr-daemonBackground daemon that refreshes modules on changes
fastapi-reloaderBrowser auto-refresh middleware for automatic page reloading

[!TIP] The hmr ecosystem is essentially stable and production-ready for most use cases. It has been carefully designed to handle many common edge cases and Pythonic magic patterns, including lazy imports, dynamic imports, module-level __getattr__, decorators, and more. However, circular dependencies in some edge cases may still cause unexpected behavior. Use with caution if you have a lot of code in __init__.py.

https://github.com/user-attachments/assets/fb247649-193d-4eed-b778-05b02d47c3f6

Other demos

  • demo/ - Basic script with hot module reloading
  • fastapi/ - FastAPI server with hot reloading and browser refresh
  • flask/ - Flask app with hot module reloading
  • mcp/ - MCP server with live code updates without connection drops

Motivation

HMR is already a common feature in the frontend world. Web frameworks like Vite supports syncing changes to the browser without a full refresh. Test frameworks like Vitest supports on-demand updating test results without a full rerun.

So, why not bring this magic to Python?

How it works

HMR uses runtime dependency tracking instead of static analysis to achieve fine-grained reactivity:

  1. Signal & Observer Pattern: Signal is an alternative to the observer pattern. I implemented a simple signal system to notify changes whenever data is accessed or modified.
  2. Custom Module Class: I implemented a custom Module class which tracks every __getattr__ and __setattr__ call. When a variable is changed, it notifies the modules that use it. This notification is recursive but fine-grained.
  3. File System Tracking: watchfiles is used to detect file changes. If a change's path is a Python module that has been imported, it triggers reloading of affected code. Additionally, HMR monitors all file reads (via sys.addaudithook) so changes to non-Python files (YAML, JSON, etc.) also trigger appropriate reloads.

This runtime approach enables variable-level granularity and can track dependencies across any file type—far more precise than static analysis.

Contributing

This might just be one of the first variable-level fine-grained HMR frameworks in the Python ecosystem—and honestly, the real magic lies in the ecosystem we build around it.

Pair uvicorn + hmr, and you've got yourself a Vite-like development experience. Combine pytest + hmr for test-driven development that rivals Vitest. The possibilities with other libraries? Endless. Let's brainstorm together—who knows what fun (or mildly chaotic) things we might create!

[!TIP] A little backstory: the code for hmr lives in another repo because, truth be told, I wasn't planning on building an HMR framework. This started as an experiment in bringing reactive programming to Python. Along the way, I realized: why not make a module's globals reactive? And that's how HMR was born! While it began as a side project, I see tremendous potential in it for advancing Python's development experience.

For now, this repo is home to the main implementation and examples. If you think HMR has potential, or you just want to throw ideas around, I'd love to hear from you. We believe that the Python community deserves a more dynamic, responsive development experience, and we're excited to see where this can take us!

Further reading

About fine-grained reactivity, I recommend reading SolidJS’s excellent explanation.

来源:README.md,提交 df49298

工具

3

learn-hmr-basics

A brief and concise explanation of the `hmr` library. This tool provides information on how to use reactive programming or use hot module reloading in Python. As long as the user mentions HMR / Reactive Programming, this tool must be called first! Don't manually view the resource, call this tool instead.

无需输入参数。

view-hmr-core-sources

The full source code (core only) of the HMR library. Always call `learn-hmr-concepts` to learn the core concepts before calling this tool. These files are the full source code of the HMR library, which would be very helpful because good code are self-documented. For a brief and concise explanation, please refer to the `hmr-docs://about` MCP resource. Make sure you've read it before calling this tool. To learn how to use HMR for reactive programming, read the unit tests later. The response is identical to the MCP resource with the same name. Only use it once and prefer this tool to that resource if you can choose.

无需输入参数。

view-hmr-unit-tests

The unit tests (code examples) for HMR. Always call `learn-hmr-basics` and `view-hmr-core-sources` to learn the core functionality before calling this tool. These files are the unit tests for the HMR library, which demonstrate the best practices and common coding patterns of using the library. You should use this tool when you need to write some code using the HMR library (maybe for reactive programming or implementing some integration). The response is identical to the MCP resource with the same name. Only use it once and prefer this tool to that resource if you can choose.

无需输入参数。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Promplate 集成