torchchat:让大语言模型无处不在
torchchat是PyTorch团队最新推出的一个小型但功能强大的代码库,旨在展示在各种设备上无缝运行大型语言模型(LLMs)的能力。无论是在服务器、桌面电脑还是移动设备上,torchchat都能让你轻松使用Python或自己的C/C++应用程序来运行LLMs。这个项目的出现,为本地LLM推理提供了一个简单而高效的解决方案。
torchchat的主要特点
torchchat虽然代码量不大,但功能却十分丰富:
- 支持多种流行的LLM模型,如Llama 3、Llama 2、Stories、Mistral等。
- 提供原生PyTorch执行,性能优异。
- 广泛支持各种硬件和操作系统,包括:
- Linux (x86)
- Mac OS (M1/M2/M3)
- Android (支持XNNPACK的设备)
- iOS 17+和8GB以上RAM的设备(如iPhone 15 Pro+或搭载Apple Silicon的iPad)
- 支持多种数据类型:float32、float16、bfloat16等。
- 提供多种量化方案。
- 多种执行模式:Python(Eager、Compile)或原生(AOT Inductor、ExecuTorch)。
这些特性使得torchchat成为一个非常灵活和强大的工具,能够适应各种不同的使用场景和需求。
torchchat能做什么?
torchchat的功能非常丰富,主要包括以下几个方面:
- 通过PyTorch/Python运行模型
- 进行交互式聊天
- 生成文本
- 在浏览器中运行聊天
- 在桌面/服务器上无需Python即可运行模型
- 使用AOT Inductor加速执行
- 使用C++运行器运行
- 在移动设备上运行模型
- 部署并在iOS上运行
- 部署并在Android上运行
- 评估模型性能
这些功能涵盖了从开发到部署的整个LLM应用流程,使得开发者可以方便地进行模型的测试、优化和部署。
安装和使用
安装torchchat非常简单,只需要几个步骤:
-
克隆代码库:
git clone https://github.com/pytorch/torchchat.git cd torchchat
-
设置虚拟环境:
python3 -m venv .venv source .venv/bin/activate
-
安装依赖:
./install_requirements.sh
安装完成后,你就可以开始使用torchchat了。torchchat提供了多种命令行接口,可以通过python3 torchchat.py --help
查看所有可用的命令。
模型下载和管理
torchchat支持多种流行的LLM模型,大多数模型使用Hugging Face作为分发渠道。你需要创建一个Hugging Face账户,并获取一个具有write
权限的用户访问令牌。
下载模型的命令很简单:
python3 torchchat.py download llama3.1
torchchat还提供了其他模型管理命令,如列出可用模型、显示模型位置、删除模型等。
通过PyTorch/Python运行模型
torchchat支持多种运行模式,最简单的方式是通过PyTorch的eager执行模式运行模型。以下是一些常用的命令:
-
聊天模式:
python3 torchchat.py chat llama3.1
-
生成模式:
python3 torchchat.py generate llama3.1 --prompt "写一个关于男孩和他的熊的故事"
-
服务器模式: torchchat还提供了一个REST API,可以通过HTTP请求与模型交互。
-
浏览器模式: 你可以在本地浏览器中与模型进行交互。
这些模式为开发者提供了灵活的选择,可以根据不同的需求选择合适的交互方式。
桌面/服务器执行
除了Python环境,torchchat还支持在桌面或服务器上无需Python即可运行模型。这主要通过AOT Inductor(AOTI)实现。
AOTI会在执行前编译模型以加速推理。它会创建一个DSO模型(扩展名为.so
的文件),然后加载该文件进行推理。这种方式既可以在Python环境中使用,也可以在C++环境中使用。
以下是一个导出和执行Llama3.1 8B Instruct模型的例子:
# 导出
python3 torchchat.py export llama3.1 --output-dso-path exportedModels/llama3.1.so
# 在Python环境中运行
python3 torchchat.py generate llama3.1 --dso-path exportedModels/llama3.1.so --prompt "你好,我的名字是"
# 在C++环境中运行
scripts/build_native.sh aoti
cmake-out/aoti_run exportedModels/llama3.1.so -z `python3 torchchat.py where llama3.1`/tokenizer.model -l 3 -i "从前有一个"
这种方式可以显著提高模型的推理速度,特别适合需要高性能的生产环境。
移动设备执行
torchchat还支持在移动设备上运行LLM模型,这是通过ExecuTorch实现的。ExecuTorch允许你优化模型以在移动或嵌入式设备上执行。
以下是在移动设备上部署和运行模型的基本步骤:
-
导出模型:
python3 torchchat.py export llama3.1 --quantize torchchat/quant_config/mobile.json --output-pte-path llama3.1.pte
-
在iOS上部署和运行: torchchat提供了详细的步骤指导如何在iOS设备上运行模型,包括使用Xcode部署应用程序。
-
在Android上部署和运行: 同样,torchchat也提供了在Android设备上运行模型的详细指南,包括使用Android Studio部署应用程序。
这些功能使得在移动设备上运行大型语言模型成为可能,为开发移动AI应用提供了强大的支持。
支持的模型
torchchat支持多种流行的LLM模型,包括:
- Meta-Llama-3.1-8B-Instruct
- Meta-Llama-3-8B-Instruct
- Llama-2-7b-chat-hf
- CodeLlama-7b-Python-hf
- Mistral-7B-Instruct-v0.2
- 等等
这些模型涵盖了不同的规模和用途,可以满足各种应用场景的需求。
设计原则
torchchat的设计遵循了PyTorch的设计哲学,特别强调"易用性高于一切"。它的主要设计原则包括:
- 原生PyTorch: torchchat是一个原生的PyTorch库,所有核心功能都是用PyTorch编写的。
- 简单性和可扩展性: torchchat设计得易于理解、使用和扩展。
- 正确性: torchchat提供经过充分测试的组件,确保高度的正确性。
这些设计原则使得torchchat不仅功能强大,而且易于使用和定制。
社区贡献
torchchat项目非常重视社区贡献。开发团队欢迎并感谢来自用户的各种贡献,这些贡献极大地丰富了项目的功能和生态系统。如果你也想为torchchat做出贡献,可以查看项目的CONTRIBUTING指南。
故障排除
在使用torchchat的过程中,你可能会遇到一些常见的问题。项目文档提供了一些常见问题的解决方案,例如模型访问限制、ExecuTorch安装失败等。如果你遇到的问题没有在文档中列出,可以查看GitHub上的issues或提交新的issue。
总结
torchchat为在各种设备上运行大型语言模型提供了一个强大而灵活的解决方案。它支持多种流行的LLM模型,提供了简单易用的接口,并针对不同平台进行了优化。无论你是想在服务器上部署高性能的LLM服务,还是在移动设备上运行轻量级的AI应用,torchchat都能满足你的需求。
随着AI技术的不断发展和普及,像torchchat这样的工具将在推动AI应用的广泛落地中发挥重要作用。它不仅为开发者提供了便利,也为AI技术的创新和应用开辟了新的可能性。我们期待看到更多基于torchchat的创新应用和解决方案,推动AI技术在各个领域的深入应用。
如果你对AI和大语言模型感兴趣,不妨尝试使用torchchat,探索LLM的无限可能。无论你是AI研究人员、开发者,还是对AI技术感兴趣的爱好者,torchchat都能为你提供一个绝佳的入门和实践平台。让我们一起,用torchchat打造更智能、更便捷的AI应用!