
parallax
把多台机器拼成一个AI超级服务器,轻松跑大模型
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1422
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Git(用于克隆 parallax 仓库)
- Python 环境(install.sh 会自动创建 .venv 虚拟环境)
- 至少一台可用的计算节点(GPU 服务器),分布式推理需多节点聚合
- 能访问 GitHub 与模型仓库的网络环境
安装与启动步骤
-
1克隆仓库
把 parallax 源码下载到本地,需保证网络能访问 GitHub。
git clone https://github.com/GradientHQ/parallax.git -
2进入项目目录
后续安装脚本与命令都必须在 parallax 仓库目录内执行。
cd parallax -
3运行安装脚本
install.sh 负责安装依赖并创建 .venv 虚拟环境,过程中请勿中断。
./install.sh -
4激活虚拟环境
激活后 parallax 命令才可用,之后每次新开终端都需重新激活。
source .venv/bin/activate -
5启动推理服务
用 -m 指定要加载的模型,启动后可接入客户端进行对话调用。
parallax serve -m Qwen/Qwen3.5-0.8B
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-m / --model | 是 | 指定要加载并对外提供推理服务的模型名称 | Qwen/Qwen3.5-0.8B |
如何确认成功
终端持续输出模型加载与节点调度日志且无报错,即表示服务已启动。
常见问题
Q:安装脚本执行失败怎么办?
A:先确认在 parallax 仓库目录内执行且网络可访问 GitHub。README 未提供更多排查细节,可到官方 Discord(discord.gg/parallaxai)求助。
Q:怎么换成别的模型?
A:启动时用 -m 参数指定其它模型即可,例如 -m Qwen/Qwen3.5-0.8B;README 提到支持 Llama、DeepSeek、GLM、Kimi 等。
Q:为什么必须 source 激活虚拟环境?
A:安装脚本把运行环境放在 .venv 中,未激活时 shell 里找不到 parallax 命令,激活后才能直接调用。
Q:和直接单机部署有什么区别?
A:Parallax 把多台机器的算力聚合成一个逻辑上的推理集群,可缓解显存不足和单机算力受限问题。
注意事项
- README 只提供 Quick Install 流程,未写端口、配置文件和硬件最低要求,请以官方文档与仓库 docs 目录为准。
- install.sh 会创建 .venv,每开一个新终端都需重新 source .venv/bin/activate。
- 所有命令都要在克隆下来的 parallax 目录中执行,否则找不到脚本和虚拟环境。
核心亮点
- 支持多种主流模型(Llama、DeepSeek、GLM等),兼容性好
- 分布式架构设计,可横向扩展节点,突破单机显存限制
- 提供类似K8s的集群管理体验,降低运维复杂度
不足之处
- 项目处于成长阶段,文档和社区生态待观察
- 分布式推理的网络通信开销可能影响性能,需优化
适用场景
- 个人或小团队利用闲置GPU构建私有推理集群
- 在边缘环境部署大模型,避免依赖云厂商
- 需要弹性扩展推理能力的生产环境
替代项目
vLLM、Ray Serve、TensorFlow Serving
上一篇:pixeltable
下一篇:WebAI-to-API
同类项目推荐
Data-Engineering-Roadmap
开源
一张图理清数据工程学习路径,从入门到实战
Roadmap for Data Engineering
cactus
开源
让手机和机器人秒级跑起 AI 模型,省电又流畅
Sub-50mb agentic, voice and vision intelligence for consumer devices.
rerun
开源
实时可视化多模态机器人数据,让调试和训练更高效
Visualize, query, and stream to train on multimodal robotics data.
ComfyUI-Installer
开源
Linux 上一键装好 ComfyUI,省去手动配环境的麻烦。
Easily install ComfyUI on a Linux system. Installs completely inside a Python venv.
ccLoad
开源
自动切换 AI 渠道,告别手动运维,提升调用稳定性
Self-hosted AI API gateway for Claude Code, Codex and Gemini: pool API keys and subs···
deepreasoning
开源
让 Claude 思考过程可见,结合 DeepSeek R1 推理链,提升 AI 决策透明度。
A high-performance LLM inference API and Chat UI that integrates DeepSeek R1's CoT r···
awesome-free-llm-apis
开源
白嫖各种免费LLM API,开发测试不花钱
List of Permanent Free LLM API (API Keys)
tool-journal
开源
让工具重试不再重复执行,崩溃后也能安全恢复
TypeScript execution journal for retryable tools: SQLite durability, lease fencing, ···
mlstacks
开源
一行配置,云端一键拉起完整 MLOps 平台
A series of Terraform based recipes to provision popular MLOps stacks on the cloud.