项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Linux 环境(Windows 为实验性支持,需走 START-MAYA.bat 流程)
- NVIDIA GPU(CUDA)或 AMD GPU(ROCm)
- 磁盘需容纳模型权重与源码构建产物
- 首次构建约 20-40 分钟(不含模型下载时间)
- 运行时引擎会占用几乎全部空闲内存(仅留约 6GB)
安装与启动步骤
-
1克隆仓库
把项目源码下载到本地并进入目录,后续所有命令都在该目录执行。
git clone https://github.com/mw00/project-maya.git && cd project-maya -
2运行安装脚本
按提示回答几个问题,直接回车即采用推荐选项;脚本会先列出全部下载内容再开始。
./setup.sh -
3等待构建与启动
脚本会完成构建(约 20-40 分钟,另加模型下载时间),结束后自动启动模型服务。
-
4打开控制台
在浏览器访问本地地址查看可视化 Dashboard,确认服务已就绪,即可开始对话或调用 API。
-
5Windows 用户启动
Windows 下改用 START-MAYA.bat 代替 setup.sh,具体步骤参见 docs/WINDOWS.md。
START-MAYA.bat -
6后续更新
可在 Dashboard 的 About > Update 升级,或先 git pull 再重跑安装脚本,模型不会重复下载。
git pull && ./setup.sh
如何确认成功
浏览器打开 http://127.0.0.1:8080 能看到 Maya 的 Dashboard 页面,即表示启动成功。
常见问题
Q:首次启动要等多久?
A:构建本身约 20-40 分钟,加上模型下载会更久;完成后 ./setup.sh 再次启动会立即拉起模型,无需重建。
Q:Windows 上怎么安装?
A:不要用 ./setup.sh,改为运行 START-MAYA.bat,详细说明见仓库 docs/WINDOWS.md。
Q:AMD 显卡能用吗?
A:支持 ROCm 后端,属于实验性支持,具体步骤见 docs/AMD_MAYA.md。
Q:怎么升级到新版本?
A:用 Dashboard 的 About > Update,或在仓库目录执行 git pull 后重新运行 ./setup.sh,已下载的模型不会重新下载。
Q:运行时其他程序很卡怎么办?
A:引擎会锁定除约 6GB 外的全部空闲内存用于专家分层,建议运行期间关闭其他占内存的程序。
注意事项
- 安装脚本会在真正下载前展示所有下载内容,确认后再继续
- 构建耗时较长(20-40 分钟)且依赖模型下载,请预留时间与磁盘
- 运行时内存占用极高,几乎占满空闲内存
- Windows 与 AMD 支持标注为实验性,遇到问题优先查阅 docs 目录对应文档
核心亮点
- 同时支持 NVIDIA CUDA 与 AMD ROCm,跨 Linux/Windows,硬件选择不被单一厂商锁定
- 内置 OpenAI 与 Anthropic 双兼容 API,现有 SDK 和工具链可低成本迁移
- 提供量化工具与 Dashboard,321B MoE 在有限显存下的部署和监控有配套方案
不足之处
- 321B MoE 模型对显存和带宽要求极高,单卡场景实际可用性依赖量化程度,官方未给出各配置的明确性能基准
- 项目处于成长早期(约千星),生产环境稳定性、长稳测试和社区案例仍需观察
适用场景
- 企业内部需要数据不出内网的 GLM 大模型私有部署
- 研究团队在多卡工作站上本地实验 321B MoE 模型
- 已有 OpenAI/Anthropic SDK 的应用希望切换到自托管后端而不改代码
替代项目
vLLM、llama.cpp
上一篇:genai-prices
下一篇:gufo
同类项目推荐
freebuff-proxy
开源
聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。
DEPRECATED — moved to https://github.com/trefeon/freelane. Archived; no longer main···
microduck
开源
用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。
A Tiny biped duck robot
ollama
开源
一条命令本地跑起大模型,免费、私密、不卡顿
Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···
soperator
开源
用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。
Run Slurm in Kubernetes
