
torchchat
一条命令在手机/电脑上跑大模型,无需服务器
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3610
使用教程
环境要求
- 已安装 Python 3.10(README 安装步骤明确要求)
- 强烈建议使用 venv 或 Conda 虚拟环境隔离依赖
- 需联网克隆仓库并安装依赖
安装与启动步骤
-
1克隆仓库
从 GitHub 克隆 torchchat 源码到本地,README 安装章节的第一步。
git clone https://github.com/pytorch/torchchat.git -
2进入项目目录
切换到克隆后的 torchchat 目录,后续所有命令都在此根目录执行。
cd torchchat -
3创建虚拟环境
README 建议用 venv 或 Conda 隔离环境,避免与其他 PyTorch 版本冲突。
python3 -m venv .venv -
4激活虚拟环境
激活后依赖只装在该环境内;Windows 需改用对应的 activate 脚本。
source .venv/bin/activate -
5安装依赖
执行官方脚本安装 torchchat 所需依赖,下载量较大、耗时较久。
./install/install_requirements.sh -
6创建导出目录
新建 exportedModels 目录,用于存放后续生成的模型导出产物。
mkdir exportedModels -
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-LLM-Large-Language-Model···
开源
一份笔记,带你系统玩转大模型应用与开发
What can I do with a LLM model?
Awesome-Chinese-LLM
开源
一站式找到适合私有化部署的中文大模型资源
整理开源的中文大语言模型,以规模较小、可私有化部署、训练成本较低的模型为主,包括底座···
awesome-opensource-ai
开源
每日更新,帮你精选最值得关注的真正开源AI项目。
Curated list of the best truly open-source AI projects, models, tools, and infrastru···
llm-resource
开源
一页看全 LLM 全栈好资源,找工具不再大海捞针
LLM全栈优质资源汇总
LLM-Research
开源
一站式收藏 LLM 论文、工具、数据集,快速上手研究。
A collection of LLM related papers, thesis, tools, datasets, courses, benchmarks
awesome-vlm-architectures
开源
一张图看懂155+视觉语言模型架构,快速选型不迷路
Curated visual catalog of 200+ vision-language model (VLM/MLLM) architectures: paper···
YAYI
开源
基于LlaMA2的中文专属大模型,让企业快速拥有安全可控的私有化AI能力。
雅意大模型:为客户打造安全可靠的专属大模型,基于大规模中英文多领域指令数据训练的 Lla···
Emu
开源
一个模型搞定图像视频生成与理解,智源出品
Emu Series: Generative Multimodal Models from BAAI
Awesome-Parallel-Reasoning
开源
一站式追踪并行推理前沿,提升LLM推理效率与质量
Awesome-Parallel-Reasoning: Unlocking the reasoning potential of LLMs. Papers, Cod···