torchchat

一条命令在手机/电脑上跑大模型,无需服务器

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 246 🐛 待处理 94 👀 关注 15 ⚠️ 作者已归档(停止维护)
GitHub ↗
GitHub 星标 ★ 3610
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,本地部署,完全免费

项目预览

torchchat 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队pytorch
定价模式🏷️完全免费
价格说明开源项目,本地部署,完全免费
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议BSD-3-Clause
主要语言Python
技术栈/模型llm,local,pytorch
GitHub 星标★ 3610
上线时间2024-03-22 00:00:00
代码更新2025-09-10
仓库体积9.2 MB
本站数据更新2026-11-08
维护状态低维护
收录时间2026-08-09
浏览次数7

项目介绍

torchchat 是一个由 PyTorch 团队推出的轻量级本地大模型推理框架,旨在让开发者能够在服务器、桌面甚至移动设备上直接运行 PyTorch 格式的 LLM。它解决了传统大模型部署依赖重型服务框架(如 vLLM、TGI)的问题,提供了一种极简、可嵌入的推理方案。核心能力包括:支持多种主流模型(如 Llama、Mistral、GPT 等)的加载与推理,提供 Python 和 C++ 双接口,支持跨平台(Linux、macOS、iOS、Android)部署,并针对移动端做了量化与优化。用户可以通过简单的命令行或几行代码,快速实现本地模型推理,而无需搭建复杂的服务端环境。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3610

技术标签

使用教程

难度:进阶 约 15 分钟 部署方式:本地安装 7 步

环境要求

  • 已安装 Python 3.10(README 安装步骤明确要求)
  • 强烈建议使用 venv 或 Conda 虚拟环境隔离依赖
  • 需联网克隆仓库并安装依赖

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 克隆 torchchat 源码到本地,README 安装章节的第一步。

    git clone https://github.com/pytorch/torchchat.git
  2. 2进入项目目录

    切换到克隆后的 torchchat 目录,后续所有命令都在此根目录执行。

    cd torchchat
  3. 3创建虚拟环境

    README 建议用 venv 或 Conda 隔离环境,避免与其他 PyTorch 版本冲突。

    python3 -m venv .venv
  4. 4激活虚拟环境

    激活后依赖只装在该环境内;Windows 需改用对应的 activate 脚本。

    source .venv/bin/activate
  5. 5安装依赖

    执行官方脚本安装 torchchat 所需依赖,下载量较大、耗时较久。

    ./install/install_requirements.sh
  6. 6创建导出目录

    新建 exportedModels 目录,用于存放后续生成的模型导出产物。

    mkdir exportedModels
  7. 7安装 ExecuTorch

    可选步骤:仅在使用 ExecuTorch/端侧(PTE)相关命令前需要,必须在 torchchat 根目录执行。

    export TORCHCHAT_ROOT=${PWD}
    ./torchchat/utils/scripts/install_et.sh

关键配置

配置项必填说明示例
TORCHCHAT_ROOT否ExecuTorch 安装脚本使用的 torchchat 根目录路径。/your/path/torchchat

如何确认成功

激活虚拟环境后 ./install/install_requirements.sh 执行无报错,即可用 --help 查看命令菜单。

常见问题

Q:install_et.sh 报 Building wheel for executorch 失败怎么办?

A:可能是链接到了其他方式安装的旧版 PyTorch(如 homebrew)。README 给出的做法是 brew uninstall pytorch 断开链接,但注意可能影响依赖它的其他程序。

Q:出现 CERTIFICATE_VERIFY_FAILED 报错怎么办?

A:README 提供的解决办法是执行 pip install --upgrade certifi 升级证书包。

Q:为什么要用虚拟环境?

A:torchchat 使用多个 PyTorch 项目的最新改动,venv 或 Conda 能避免与系统已有 PyTorch 版本相互干扰。

注意事项

  • torchchat 已不再处于活跃开发状态,详见 GitHub issue 1543。
  • ExecuTorch 相关命令必须在 torchchat 根目录下执行。
  • iOS/Android 端部署前需先完成 ExecuTorch 安装(Set Up ExecuTorch)。
  • README 提示可用 --help 查看各命令参数,定制编译与量化等选项。

核心亮点

  • 自带 C++ 运行时,可无缝部署到 iOS/Android,移动端推理体验流畅
  • 支持多种主流模型架构(Llama、Mistral 等),且与 PyTorch 生态无缝集成
  • 提供 Python 和 C++ 双 API,既适合快速原型,也适合生产环境嵌入

不足之处

  • 文档/社区待观察
  • 相比 vLLM 等专用推理引擎,在高并发服务场景下性能优化有限

适用场景

  • 在移动设备上离线运行聊天机器人或智能助手
  • 在边缘设备(如树莓派)上部署私有 LLM 服务
  • 快速原型验证 PyTorch 模型的本地推理效果

替代项目

llama.cpp、Ollama、MLC LLM

上一篇:NExT-GPT

下一篇:MiniMax-01

同类项目推荐

Awesome-Chinese-LLM 开源

一站式找到适合私有化部署的中文大模型资源

整理开源的中文大语言模型,以规模较小、可私有化部署、训练成本较低的模型为主,包括底座···

★ 22778 2026-08-09
awesome-opensource-ai 开源

每日更新,帮你精选最值得关注的真正开源AI项目。

Curated list of the best truly open-source AI projects, models, tools, and infrastru···

★ 4997 2026-08-09
llm-resource 开源

一页看全 LLM 全栈好资源,找工具不再大海捞针

LLM全栈优质资源汇总

★ 728 2026-08-09
LLM-Research 开源

一站式收藏 LLM 论文、工具、数据集,快速上手研究。

A collection of LLM related papers, thesis, tools, datasets, courses, benchmarks

★ 67 2026-08-09
awesome-vlm-architectures 开源

一张图看懂155+视觉语言模型架构,快速选型不迷路

Curated visual catalog of 200+ vision-language model (VLM/MLLM) architectures: paper···

★ 1358 2026-08-09
YAYI 开源

基于LlaMA2的中文专属大模型,让企业快速拥有安全可控的私有化AI能力。

雅意大模型:为客户打造安全可靠的专属大模型,基于大规模中英文多领域指令数据训练的 Lla···

★ 2526 2026-08-09
Emu 开源

一个模型搞定图像视频生成与理解,智源出品

Emu Series: Generative Multimodal Models from BAAI

★ 1776 2026-08-09
Awesome-Parallel-Reasoning 开源

一站式追踪并行推理前沿,提升LLM推理效率与质量

Awesome-Parallel-Reasoning: Unlocking the reasoning potential of LLMs. Papers, Cod···

★ 57 2026-08-09