以下是 Shimmy 的安装方法及关键注意事项，综合多个来源整理：

一、安装方式

1. 通过 Cargo 安装（推荐）

   • 适用场景：需要灵活管理依赖、开发环境或希望自动更新。

   • 步骤：

     1. 安装 Rust 和 Cargo（若未安装）：
        curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
        source ~/.cargo/env
        
     2. 安装 Shimmy：
        cargo install shimmy
        
   • 优势：自动获取最新版本，支持跨平台（Linux/macOS/Windows）。

2. 直接下载二进制文件

   • 适用场景：快速部署、无 Rust 环境或需要离线安装。

   • 步骤：

     1. 访问 https://github.com/Michael-A-Kuykendall/shimmy/releases。
     2. 根据操作系统下载对应文件：
        ▪ Windows：shimmy-x86_64-pc-windows-msvc.zip（需解压为 .exe）。

        ▪ macOS：shimmy-x86_64-apple-darwin（Intel 芯片）或 shimmy-aarch64-apple-darwin（Apple Silicon）。

        ▪ Linux：shimmy-x86_64-unknown-linux-gnu。

     3. 将二进制文件放置到系统路径（如 /usr/local/bin 或自定义目录）。
   • 注意：Windows 用户可能需在 Defender 中添加排除项，避免误报。

二、模型配置

Shimmy 不自带模型，需手动下载并放置到指定目录：
1. 模型格式：仅支持 GGUF 格式（如 Phi-3、Llama 系列等）。
2. 下载方法：
   • 使用 huggingface-cli 下载模型到本地目录：
     pip install huggingface-hub
     huggingface-cli download microsoft/Phi-3-mini-4k-instruct-gguf --local-dir ./models/
     
   • 或从其他来源获取模型文件（如 Ollama 模型目录）。

3. 自动发现路径：
   • Shimmy 默认扫描以下路径：

     ◦ ~/.cache/huggingface/hub/（Hugging Face 缓存）

     ◦ ~/.ollama/models/（Ollama 模型目录）

     ◦ ./models/（当前目录）

   • 也可通过环境变量 SHIMMY_BASE_GGUF 指定自定义路径。

三、启动服务

1. 基础命令：
   shimmy serve
   
   • 自动分配端口（默认 http://localhost:11435）。

2. 高级配置：
   • 指定端口：
     shimmy serve --bind 127.0.0.1:11435
     
   • 指定模型文件：
     shimmy serve --model /path/to/model.gguf
     
   • 同时指定模型和端口：
     shimmy serve --model ~/models/phi-3.gguf --port 3000
     
   • 列出可用模型：
     shimmy list
     
   • 刷新模型发现：
     shimmy discover
     
   

四、常见问题

1. Windows 兼容性：
   • 若二进制文件无法运行，建议通过 Cargo 安装或检查 Defender 设置。

2. 模型加载失败：
   • 确认模型文件路径正确，且为 GGUF 格式。

   • 检查是否在 models/ 目录或配置的环境变量路径中。

3. 端口冲突：
   • 使用 --port 参数手动指定未被占用的端口。

五、Docker 部署（可选）

1. 创建模型目录并下载模型：
```请在此输入代码块语言
   mkdir models
   curl -L "https://huggingface.co/microsoft/Phi-3-mini-4k-instruct-gguf/resolve/main/Phi-3-mini-4k-instruct-q4.gguf" -o models/phi-3-mini.gguf```
   
2. 启动容器：
   docker run -v $(pwd)/models:/app/models -p 11435:11435 shimmy
   
   

总结

Shimmy 的安装流程极简，核心优势在于 轻量化（5.1MB）和 零配置自动发现模型。推荐优先通过 Cargo 安装以获取最新功能，模型部署时需注意路径配置。如需进一步优化性能，可尝试 LoRA 适配器或 Metal GPU 加速（macOS）。


通过 Cargo 安装（推荐）• 适用场景：需要灵活管理依赖、开发环境或希望自动更新。• 步骤：

Shimmy，超越ollama?

人工智能

后端

开发工具

Shimmy提供两种安装方式：通过Cargo安装（推荐）或直接下载二进制文件。支持GGUF格式模型，需手动下载并配置路径。启动服务时可指定端口和模型文件，支持自动发现模型路径。Windows用户需注意Defender设置，建议优先选择Cargo安装以获取最新功能。

Windows

容器

Linux

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Shimmy，超越ollama?-腾讯云开发者社区-腾讯云

Shimmy，超越ollama?

Shimmy，超越ollama?

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐