安装教程
July 10, 2025 · View on GitHub
下载地址
首先根据你的操作系统，下载对应的 APP 安装包并安装：
安装依赖（Windows）
对于 Windows 用户，需要先安装 Microsoft Visual C++ 运行时才能正常运行。
下载地址：https://aka.ms/vs/17/release/vc_redist.x64.exe
下载模型
首次启动 APP，需要下载模型文件（默认会自动下载），初始化成功后才能使用。
如果你的下载进度一直是 0，或者下到一半卡住了，请按照下面的步骤手动初始化：
下载模型文件
首先根据你的操作系统，选择对应的模型文件： https://gh-proxy.com/github.com/idootop/MagicMirror/releases/download/server-v1.0.0/server_windows_x86_64.zip
如果你访问不了上面的 GitHub 下载链接，可以使用国内的下载地址
解压下载的文件
解压后应该是一个文件夹，把它重命名成: MagicMirror 然后移动到你电脑的 HOME 目录下，比如：
完成上面两步后，重启 MagicMirror 应该就能正常启动了。
启动 APP
下载完模型文件后，第一次启动应用可能比较缓慢，耐心等待即可。
一般 3 分钟以内即可启动成功，如果超过 10 分钟还未正常启动，请查看常见问题