npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@waytoagi/lmstudio-mirror-switcher

v1.0.2

Published

A tool for switching the mirror of LM Studio

Downloads

108

Readme

🚀 LM Studio Mirror Switcher | 镜像切换工具

Supercharge your LM Studio downloads with lightning-fast Chinese mirrors! No proxy needed. 🔥

使用国内高速镜像为 LM Studio 提速,无需代理即可畅快下载模型!

✨ Features | 功能特点

  • 🔍 Auto-detect LM Studio installation directory
  • 🔄 One-click switch from huggingface.co to hf-mirror.com
  • 💾 Backup creation before making any changes
  • 🌐 Cross-platform support for Windows, macOS, and Linux
  • 🛡️ Safe & reversible operations with restore capability
  • 💻 Interactive CLI with user-friendly prompts

🚀 Quick Start | 快速开始

Method 1: Using npx (Recommended) | 方法一:使用 npx(推荐)

npx @waytoagi/lmstudio-mirror-switcher

Method 2: Global Installation | 方法二:全局安装

npm install -g @waytoagi/lmstudio-mirror-switcher
lmstudio-mirror-switcher

Method 3: Direct Execution | 方法三:直接运行

git clone https://github.com/yourusername/lmstudio-mirror-switcher.git
cd lmstudio-mirror-switcher
npm install
npm start

Method 4: Executable File | 方法四:使用可执行文件

Download from Releases and run directly.

📖 Usage Guide | 使用指南

  1. Run the tool and it will automatically search for LM Studio installation directories
  2. Select the correct directory if multiple options are found
  3. Manually input the path if not detected automatically
  4. Close LM Studio before confirming the operation
  5. Create a backup when prompted (highly recommended)
  6. After completion, launch LM Studio which will now use hf-mirror.com

⚠️ Important Notes | 注意事项

  • Close LM Studio before running this tool
  • Always create a backup before making changes
  • This tool only replaces huggingface.co with hf-mirror.com
  • If issues occur, use the backup to restore original files

🔍 Troubleshooting | 常见问题

Can't find LM Studio installation directory | 找不到 LM Studio 安装目录

Possible causes:

  • Non-standard installation location
  • Unsupported platform

Solutions:

  • Manually specify the LM Studio installation path
  • For macOS: typically /Applications/LM Studio.app/Contents/Resources/app
  • For Windows: typically C:\Users\username\AppData\Local\LM-Studio\resources\app

LM Studio doesn't work after replacement | 替换后 LM Studio 无法正常工作

Possible causes:

  • Errors during replacement
  • Incompatible LM Studio version

Solutions:

  • Restore from backup
  • Reinstall LM Studio

🛠️ For Developers | 开发者信息

# Install dependencies | 安装依赖
npm install

# Build npm package | 构建 npm 包
npm run build

# Build executables | 构建可执行文件
npm run pkg-all

📝 Why Use This Tool? | 为什么使用本工具?

If you're in China or regions with limited access to huggingface.co, downloading models through LM Studio can be painfully slow or impossible without a VPN. This tool automatically replaces all references to huggingface.co with hf-mirror.com (a fast Chinese mirror) in your LM Studio installation, allowing you to download models at full speed without any proxy configuration.

在中国或其他访问 huggingface.co 受限的地区,通过 LM Studio 下载模型可能非常缓慢,甚至在没有 VPN 的情况下无法下载。本工具自动将 LM Studio 安装目录中所有对 huggingface.co 的引用替换为 hf-mirror.com(一个快速的中国镜像站),让您无需任何代理配置即可以全速下载模型。

📜 License | 许可证

MIT