安装脚本会创建 .venv,需先 source 激活才能用 parallax 命令;首次运行需从 HuggingFace 拉取模型权重;GPU 与 Mac 后端分别依赖 SGLang/vLLM 和 MLX LM,需按平台准备对应环境。

parallax
GradientHQApache-2.0更新放缓分布式模型服务框架,能把多台机器组成自建 AI 推理集群,用来跑 Llama、DeepSeek 等大模型。
Parallax is a distributed model serving framework that lets you build your own AI cluster anywhere
git clone https://github.com/GradientHQ/parallax.git
cd parallax
./install.sh
source .venv/bin/activate
parallax serve -m Qwen/Qwen3.5-0.8BREADME 未说明具体显存与 GPU 型号要求;支持跨平台部署,GPU 走 SGLang/vLLM 后端,Mac 走 MLX LM 后端。
分布式模型推理框架,把配置各异的设备组成你自己的 AI 集群
分布式模型服务框架,能把多台机器组成自建 AI 推理集群,用来跑 Llama、DeepSeek 等大模型。
核心能力
- 用流水线并行把模型分片到多个节点
- Mac 端用 Paged KV cache 与连续批处理
- 动态请求调度与路由提升吞吐
- P2P 通信由 Lattica 支撑跨节点互联
- GPU 后端接 SGLang/vLLM,Mac 后端接 MLX LM
容易踩的坑
- v0.1.2最新正式版2025-12-02 · 2025-12-02 07:53 UTC
Highlights
- Add paged kv implement
- Support switch model in chat page
What's Changed
- chore(version): upgrade mlx to 0.30.0 which has arm64 wheel by @gufengc in https://github.com/GradientHQ/parallax/pull/284
- chore(version): Revert upgrade mlx to 0.30.0 which has arm64 wheel by @gufengc in https://github.com/GradientHQ/parallax/pull/285
- refactor(test): refactor test_executor for mix backend by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/287
- chore(lattica): upgrade lattica to 1.0.14 to support lower glibc by @gufengc in https://github.com/GradientHQ/parallax/pull/288
- refactor(executor): Separate executor code with different backends by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/291
- feat(backend): add mac lora function by @wasamtc in https://github.com/GradientHQ/parallax/pull/283
- feat(backend): switch model by @JasonOE in https://github.com/GradientHQ/parallax/pull/289
- feat(pagedkv): Add paged kv implement by @yuhao-zh in https://github.com/GradientHQ/parallax/pull/278
- chore(version): update version to 0.1.2 by @sl-gn in https://github.com/GradientHQ/parallax/pull/300
Full Changelog: https://github.com/GradientHQ/parallax/compare/v0.1.1...v0.1.2
- v0.1.12025-11-26 · 2025-11-26 04:17 UTC
查看更新说明
Highlights
- Add docker image for dgx spark
- Support huggingface offline
- Refactor executor and p2p server use sub-process instead of sub-thread
- Add paged attn naive kernel
What's Changed
- chore(lattica): upgrade lattica to 1.0.10 by @gufengc in https://github.com/GradientHQ/parallax/pull/221
- fix(executor): initialize http_requests list for ingesting new requests by @RWL-Dittrich in https://github.com/GradientHQ/parallax/pull/217
- feat(backend): add flags use hugging face cache by @JasonOE in https://github.com/GradientHQ/parallax/pull/220
- fix(backend): add param_hosting_ratio for estimate varm required by @sl-gn in https://github.com/GradientHQ/parallax/pull/224
- feat(scheduler): Launch TP>0 as subprocesses & fit scheduler by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/222
- fix(bug): Prevent node duplication during leftover node allocation by @IAMDAVID0920 in https://github.com/GradientHQ/parallax/pull/209
- fix(backend): fix monkey patch taking no effect by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/228
- chore(lattica): show lattica log in debug mode by @gufengc in https://github.com/GradientHQ/parallax/pull/231
- feat(scheduler): warmup before global rebalance by @JasonOE in https://github.com/GradientHQ/parallax/pull/204
- fix(bug): just change kvcache and param_host name by @wasamtc in https://github.com/GradientHQ/parallax/pull/229
- fix(scheduler): ignore node update if it is not in node list by @gufengc in https://github.com/GradientHQ/parallax/pull/232
- docs(readme): add partner zai by @sl-gn in https://github.com/GradientHQ/parallax/pull/233
- docs(fqa): add faq in user guide by @sl-gn in https://github.com/GradientHQ/parallax/pull/234
- docs(faq): add two qa by @sl-gn in https://github.com/GradientHQ/parallax/pull/235
- fix(test): fix executor test on gpu by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/236
- fix(server): surface chat-template errors by @Odysseusailoon in https://github.com/GradientHQ/parallax/pull/208
- fix(backend): fix vram estimate error when use hf local cache by @sl-gn in https://github.com/GradientHQ/parallax/pull/238
- fix(backend): skip load model info if model path is speficied by @gufengc in https://github.com/GradientHQ/parallax/pull/241
- chore(lattica): upgrade lattica to 1.0.12 by @gufengc in https://github.com/GradientHQ/parallax/pull/243
- feat(pre-commit): Hide whitespace by @yuhao-zh in https://github.com/GradientHQ/parallax/pull/249
- fix(backend): fix model list api error if not init model info from config by @sl-gn in https://github.com/GradientHQ/parallax/pull/250
- docs(dgx spark): Add dgx spark docker by @gufengc in https://github.com/GradientHQ/parallax/pull/251
- feat(backend): add vllm support by @yuhao-zh in https://github.com/GradientHQ/parallax/pull/223
- feat(docker): build docker for dgx spark by @gufengc in https://github.com/GradientHQ/parallax/pull/244
- chore(docker): build docker daily by @gufengc in https://github.com/GradientHQ/parallax/pull/253
- fix(tokenizer): fix tokenizer bug by @gufengc in https://github.com/GradientHQ/parallax/pull/255
- fix(eos): fix eos check by @gufengc in https://github.com/GradientHQ/parallax/pull/256
- chore(sglang): upgrade sglang to 0.5.5 by @gufengc in https://github.com/GradientHQ/parallax/pull/257
- feat(frontend): supports display gpu number in node by @xz-gradient in https://github.com/GradientHQ/parallax/pull/258
- chore(docs): update docker doc by @gufengc in https://github.com/GradientHQ/parallax/pull/259
- fix(model_download): exit when node's network cannot connect huggingface.co by @yuhao-zh in https://github.com/GradientHQ/parallax/pull/252
- fix(model): fix kimi k2 on mac by @gufengc in https://github.com/GradientHQ/parallax/pull/260
- fix(tokenizer): fix eos token id if it is a list by @gufengc in https://github.com/GradientHQ/parallax/pull/263
- fix(loader): fix bug when tie_word_embeddings is true
- v0.1.02025-11-11 · 2025-11-11 12:29 UTC
查看更新说明
Highlights
- Support for Kimi-K2, DeepSeek, MiniMax, GLM and gpt-oss-safeguard
- Optimize communication methods and add relay server support for remote connections
- Add parallax chat command to run a chat page server
- Adjust the readme structure and improve the user guide and contributing guide
What's Changed
- fix(frontend): chat page sidebar subtitle and add node dialog by @xz-gradient in https://github.com/GradientHQ/parallax/pull/44
- fix(node): Fixed the issue of slow reporting of node leave by @sl-gn in https://github.com/GradientHQ/parallax/pull/46
- fix(frontend): setup input, node offline by @xz-gradient in https://github.com/GradientHQ/parallax/pull/47
- feat(model): Add Model kimi k2(DeepSeekV3) by @yuhao-zh in https://github.com/GradientHQ/parallax/pull/10
- docs(readme): update readme for scheduling algorithm by @Youhe-Jiang in https://github.com/GradientHQ/parallax/pull/43
- chore(lattica): use lattica 1.0.0 by @gufengc in https://github.com/GradientHQ/parallax/pull/50
- fix(batch scheduler): add mlx model name map & add gpt-oss monkey patch by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/45
- fix: ui issues by @yuyin-zhang in https://github.com/GradientHQ/parallax/pull/49
- feat(frontend): chat message output fit gpt format by @xz-gradient in https://github.com/GradientHQ/parallax/pull/51
- feat(readme): update readme for product by @ramenyu in https://github.com/GradientHQ/parallax/pull/52
- feat(readme): update readme images by @ramenyu in https://github.com/GradientHQ/parallax/pull/53
- feat(backend): add ascii animation for parallax run/parallax join by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/48
- feat(Relay): Adding relay server by @gufengc in https://github.com/GradientHQ/parallax/pull/19
- fix(frontend): UI improvements for chat, sidebar, select, and number input by @yuyin-zhang in https://github.com/GradientHQ/parallax/pull/55
- fix(model): mlx gpt-oss model name by @gufengc in https://github.com/GradientHQ/parallax/pull/59
- chore(readme): Update README.md by @Youhe-Jiang in https://github.com/GradientHQ/parallax/pull/58
- feat(backend): Backend support connnect relay server & Disable caching for index.html by @sl-gn in https://github.com/GradientHQ/parallax/pull/56
- feat(readme): update readme images and cluster setup tutorial by @ramenyu in https://github.com/GradientHQ/parallax/pull/57
- fix(node): Close http server process in finally and fix the problem t… by @sl-gn in https://github.com/GradientHQ/parallax/pull/61
- fix(readme): update supported models info and add is-local-network param when start backend by @sl-gn in https://github.com/GradientHQ/parallax/pull/62
- fix(scheduler): Layer allocator parameter size calculation by @TianyiZhao1437 in https://github.com/GradientHQ/parallax/pull/60
- feat(scheduler): sending chat complete request through p2p by @gufengc in https://github.com/GradientHQ/parallax/pull/63
- fix(node): change ascii animation display time by @sl-gn in https://github.com/GradientHQ/parallax/pull/64
- docs(readme): add uninstalling in readme by @sl-gn in https://github.com/GradientHQ/parallax/pull/65
- fix(http): fix localhost bypass proxy by @gufengc in https://github.com/GradientHQ/parallax/pull/67
- fix(LICENSE): Create LICENSE by @sl-gn in https://github.com/GradientHQ/parallax/pull/66
- fix(description): update project description and cli help info and re… by @sl-gn in https://github.com/GradientHQ/parallax/pull/68
- fix(scheduler): Fix not read model config from cache by @gufengc in https://github.com/GradientHQ/parallax/pull/70
- fix(relay): scheduler add default initial_peers in remote mode by @sl-gn in https://github.com/GradientHQ/parallax/pull/69
- chore(lattica): upgrade lattica to 1.0.4 by @gufengc in https://github.com/GradientHQ/parallax/pull/71
- feat(model): Add qwen3-235B-int4 by @gufengc in https://github.com/GradientHQ/parallax/pull/72
- feat(readme): Guide macOS to us
- v0.0.12025-09-29 · 2025-09-29 10:03 UTC
这个版本没有写更新说明。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Gradient | Blog | X/Twitter (Gradient) | X/Twitter (Parallax) | Discord | Arxiv
News
- [2026/02] 🦞 Parallax now supports OpenClaw integration! See Docs
- [2025/10] 🔥 Parallax won #1 Product of The Day on Product Hunt!
- [2025/10] 🔥 Parallax version 0.0.1 has been released!
About
A fully decentralized inference engine developed by Gradient. Parallax lets you build your own AI cluster for model inference onto a set of distributed nodes despite their varying configuration and physical location. Its core features include:
- Host local LLM on personal devices
- Cross-platform support
- Pipeline parallel model sharding
- Paged KV cache management & continuous batching for Mac
- Dynamic request scheduling and routing for high performance
The backend architecture:
- P2P communication powered by Lattica
- GPU backend powered by SGLang and vLLM
- Mac backend powered by MLX LM
User Guide
Quick Install
git clone https://github.com/GradientHQ/parallax.git
cd parallax
./install.sh
source .venv/bin/activate
parallax serve -m Qwen/Qwen3.5-0.8B
Contributing
We warmly welcome contributions of all kinds! For guidelines on how to get involved, please refer to our Contributing Guide.
Supported Models
| Provider | HuggingFace Collection | Blog | Description | |
|---|---|---|---|---|
| DeepSeek | Deepseek | DeepSeek-V3.2DeepSeek-R1 | DeepSeek-V3.2 Release | DeepSeek-V3.2 is built for stronger reasoning and agent workflows, adding thinking-aware tool use while keeping both thinking and non-thinking tool-use modes available. |
| MiniMax | MiniMax AI | MiniMax-M3MiniMax-M2.7 | MiniMax M3: Frontier Coding, 1M Context, Native Multimodality | MiniMax-M3 is a sparse-attention model for coding, agentic work, long-context tasks, and multimodal input, with MiniMax-M2.7 kept as a supported sibling model. |
| GLM | Z AI | GLM-5.2GLM-5.1GLM-4.7 | GLM-5.2: Built for Long-Horizon Tasks | GLM-5.2 is Z AI's latest flagship model for long-horizon coding agents, large-scale implementation, automated research, and performance optimization. |
| Kimi-K2 | Moonshot AI | Kimi-K2-ThinkingKimi-K2-Instruct-0905 | Kimi K2 Thinking | Kimi-K2-Thinking is the reasoning-focused Kimi-K2 variant for long-horizon agentic workflows, multi-step reasoning, and tool-heavy tasks. |
| Qwen | Qwen | Qwen3.6-35B-A3B | Qwen3.6-35B-A3B: Agentic Coding Power, Now Open to All | Qwen3.6-35B-A3B is an open-weight MoE model focused on stable, practical coding and agentic workflows, with Qwen3-Next and larger Qwen3 MoE variants also represented. |
| gpt-oss | OpenAI | gpt-oss-120bgpt-oss-safeguard-120b | Introducing gpt-oss-safeguard | gpt-oss-120b is OpenAI's open-weight GPT model; gpt-oss-safeguard-120b adds policy-driven reasoning classification for flexible moderation and safety workflows. |
| Step | StepFun | Step-3.5-Flash | Step 3.5 Flash | Step-3.5-Flash is a sparse MoE foundation model for efficient reasoning and agentic workflows, activating a small subset of its total parameters per token. |