项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 10925
使用教程
环境要求
- 已安装 Docker(Docker Desktop 或 Docker Engine 均可)
- 支持 x86 或 arm64 架构的系统
- M1/M2 Mac 上还需安装 Xcode
- 如需 GPU 加速,需具备 Nvidia GPU
- 使用 Kubernetes 部署时需有可用集群并配置好 kubectl
安装与启动步骤
-
1克隆项目仓库
把 llama-gpt 源码下载到本地,需要能访问 GitHub 网络。
git clone https://github.com/getumbrel/llama-gpt.git -
2进入项目目录
切换到刚克隆下来的目录,后续命令都在此目录下执行。
cd llama-gpt -
3Docker 启动服务
在任意 x86/arm64 系统上运行,默认使用 7B 模型;13B、70B 把 7b 换成 13b、70b。
./run.sh --model 7b -
4启用 GPU 加速(可选)
有 Nvidia GPU 时加上 --with-cuda 参数,可显著提升推理速度。
./run.sh --model 7b --with-cuda -
5M1/M2 Mac 启动
Mac 用户改用 run-mac.sh;Code Llama 模型可用 code-7b、code-13b、code-34b。
./run-mac.sh --model 7b -
6Kubernetes 部署(可选)
先创建 llama 命名空间,再应用 deploy/kubernetes 下的清单,之后按自己方式暴露服务。
kubectl create ns llama kubectl apply -k deploy/kubernetes/. -n llama -
7访问聊天界面
服务就绪后浏览器打开 http://localhost:3000 即可对话,停止服务在终端按 Ctrl+C。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--model | 是 | 指定使用的模型规格,7b/13b/70b 为对话模型 | 7b |
--model (Code Llama) | 否 | 使用代码模型时填 code-7b / code-13b / code-34b | code-7b |
--with-cuda | 否 | 有 Nvidia GPU 时启用 CUDA 加速推理 | --with-cuda |
-n llama | 否 | Kubernetes 部署时指定的命名空间 | llama |
如何确认成功
终端出现 ready - started server on 0.0.0.0:3000,浏览器打开 http://localhost:3000 能正常对话即成功。
常见问题
Q:第一次运行很久没反应,是不是出错了?
A:正常现象。首次运行会自动下载模型到 /models 目录,期间会反复输出 Host not yet available 之类日志,等模型下载加载完成即可。
Q:怎么换成更大的模型?
A:把命令里的 --model 7b 换成 13b 或 70b 即可,Code Llama 则用 code-7b、code-13b、code-34b。
Q:没有 Nvidia GPU 能跑吗?
A:可以。不加 --with-cuda 时在任意 x86 或 arm64 系统上通过 Docker 运行,只是推理速度较慢。
Q:如何停止服务?
A:在运行命令的终端里按 Ctrl + C 即可停止。
Q:Mac 上能用同样的命令吗?
A:不能,M1/M2 Mac 需改用 ./run-mac.sh --model 7b,并提前安装好 Docker 和 Xcode。
注意事项
- 全程离线运行,聊天数据不会离开本地设备
- 模型会自动下载到 /models 目录,首次启动耗时较长
- 更换模型只需修改 --model 参数,无需改代码
- Kubernetes 部署后需自行决定如何对外暴露服务
核心亮点
- 完全离线运行,数据零外泄,隐私保护拉满
- 支持 Llama 2 和 Code Llama,代码生成能力实用
- Docker 一键部署,上手门槛低
不足之处
- 模型体积大,低配设备运行卡顿
- 文档/社区待观察
适用场景
- 企业内部知识库问答,敏感数据不外传
- 开发者本地调试代码生成,无需联网
- 个人隐私聊天助手,替代云端服务
替代项目
Ollama、LocalAI、text-generation-webui
上一篇:SillyTavern
下一篇:apfel
同类项目推荐
Robby-chatbot
开源
上传文件或视频链接,即可用自然语言提问并获取答案
AI chatbot for chat with CSV, PDF, TXT files and YTB videos | using Langchain | O···
chatbot
开源
用C语言打造越南语聊天机器人,实现基础问答对话
Vietnamese Chatbot
PTChatGPT
开源
在 iOS 上原生体验 ChatGPT 与图像生成,一站式搞定。
I thik that is a full function iOS ChatGPT app
simplechat
开源
让团队安全地与文档、音视频对话,提升协作效率
Secure AI conversations with documents, video, audio, and more. Personal workspaces ···
gitagpt
开源
让《薄伽梵歌》智慧帮你解答人生困惑,AI 随时对话。
Gita GPT A personal productivity assistant (RAG), a platform of AI chatbots, Ask Kri···
openai-whisper-talk
开源
用 OpenAI 全家桶,快速搭一个能听会说的语音聊天机器人
openai-whisper-talk is a sample voice conversation application powered by OpenAI tec···
chatgpt-wechat-landing-page
开源
让ChatGPT替你回微信,@消息秒回不遗漏
一个 Chrome 浏览器插件,通过 ChatGPT 来自动响应微信私信或群聊中 @你 的消息的智能聊天···
maxigo-client
开源
用 Go 写 Max 机器人,零依赖、带上下文、错误清晰,开箱即用。
Idiomatic Go HTTP client for Max Bot API — zero dependencies, context support, stru···
python-whatsApp-bot
开源
用 Python 快速搭建 WhatsApp 自动回复机器人
Make WhatsApp ChatBot and use WhatsApp API to send the WhatsApp messages in python .
