MCPcopy Index your code
hub / github.com/GradientHQ/parallax

github.com/GradientHQ/parallax @v0.1.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.2 ↗ · + Follow
999 symbols 3,618 edges 188 files 528 documented · 53%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
<img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/parallax.png" width="720">

Trusted by Partners

  <img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/qwen.avif" alt="Qwen" height="30" style="margin: 0 20px;">
  <img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/sglang.png" alt="SGLang" height="28" style="margin: 0 20px;">
  <img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/kimi.png" alt="Kimi" height="30" style="margin: 0 20px;">
  <img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/minimax.png" alt="Minimax" height="30" style="margin: 0 10px;">
  <img src="https://github.com/GradientHQ/parallax/raw/v0.1.2/docs/images/zai.svg"za alt="ZAI" height="30" style="margin: 0 10px;"/>

license issue resolution open issues

Parallax by Gradient - Host LLMs across devices sharing GPU to make your AI go brrr | Product Hunt

| Gradient | Blog | X(Twitter) | Discord | Arxiv

News

  • [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
  • Dynamic 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
  • MAC backend powered by MLX LM

User Guide

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.1

DeepSeek-R1

DeepSeek-V3

DeepSeek-V2 | DeepSeek V3.1: The New Frontier in Artificial Intelligence | "DeepSeek" is an advanced large language model series from Deepseek AI, offering multiple generations such as DeepSeek-V3.1, DeepSeek-R1, DeepSeek-V2, and DeepSeek-V3. These models are designed for powerful natural language understanding and generation, with various sizes and capabilities for research and production use. | |MiniMax-M2 | MiniMax AI | MiniMax-M2 | MiniMax M2 & Agent: Ingenious in Simplicity | MiniMax-M2 is a compact, fast, and cost-effective MoE model (230B parameters, 10B active) built for advanced coding and agentic workflows. It offers state-of-the-art intelligence and coding abilities, delivering efficient, reliable tool use and strong multi-step reasoning for developers and agents, with high throughput and low latency for easy deployment. | |GLM-4.6 | Z AI | GLM-4.6 | GLM-4.6: Advanced Agentic, Reasoning and Coding Capabilities | GLM-4.6 improves upon GLM-4.5 with a longer 200K token context window, stronger coding and reasoning performance, enhanced tool-use and agent integration, and refined writing quality. Outperforms previous versions and is highly competitive with leading open-source models across coding, reasoning, and agent benchmarks. | |Kimi-K2 | Moonshot AI | Kimi-K2 | Kimi K2: Open Agentic Intelligence | "Kimi-K2" is Moonshot AI's Kimi-K2 model family, including Kimi-K2-Base, Kimi-K2-Instruct and Kimi-K2-Thinking. Kimi K2 Thinking is a state-of-the-art open-source agentic model designed for deep, step-by-step reasoning and dynamic tool use. It features native INT4 quantization and a 256k context window for fast, memory-efficient inference. Uniquely stable in long-horizon tasks, Kimi K2 enables reliable autonomous workflows with consistent performance across hundreds of tool calls. |Qwen | Qwen | Qwen3-Next

Qwen3

Qwen2.5| Qwen3-Next: Towards Ultimate Training & Inference Efficiency | The Qwen series is a family of large language models developed by Alibaba's Qwen team. It includes multiple generations such as Qwen2.5, Qwen3, and Qwen3-Next, which improve upon model architecture, efficiency, and capabilities. The models are available in various sizes and instruction-tuned versions, with support for cutting-edge features like long context and quantization. Suitable for a wide range of language tasks and open-source use cases. | |gpt-oss | OpenAI | gpt-oss

gpt-oss-safeguard | Introducing gpt-oss-safeguard | gpt-oss are OpenAI’s open-weight GPT models (20B & 120B). The gpt-oss-safeguard variants are reasoning-based safety classification models: developers provide their own policy at inference, and the model uses chain-of-thought to classify content and explain its reasoning. This allows flexible, policy-driven moderation in complex or evolving domains, with open weights under Apache 2.0. | |Meta Llama 3 | Meta | Meta Llama 3

Llama 3.1

Llama 3.2

Llama 3.3 | Introducing Meta Llama 3: The most capable openly available LLM to date | "Meta Llama 3" is Meta's third-generation Llama model, available in sizes such as 8B and 70B parameters. Includes instruction-tuned and quantized (e.g., FP8) variants. |

Extension points exported contracts — how you extend this code

MainLayoutProps (Interface)
(no doc)
src/frontend/src/components/common/main-layout.tsx
NotificationProps (Interface)
(no doc)
src/frontend/src/components/mui/alert/notification.tsx
TitleIconClasses (Interface)
(no doc)
src/frontend/src/components/mui/title-icon/title-icon-classes.ts
TitleIconOwnerState (Interface)
(no doc)
src/frontend/src/components/mui/title-icon/title-icon-props.ts
TitleIconPropsVariantOverrides (Interface)
(no doc)
src/frontend/src/components/mui/title-icon/title-icon-props.ts

Core symbols most depended-on inside this repo

get
called by 253
src/parallax/utils/shared_state.py
get_logger
called by 33
src/parallax_utils/logging_config.py
get_decoder_layer_capacity
called by 29
src/scheduling/node.py
join
called by 27
src/scheduling/scheduler.py
useRefCallback
called by 23
src/frontend/src/hooks/use-callback.ts
has_full_pipeline
called by 22
src/scheduling/layer_allocation.py
debugLog
called by 19
src/frontend/src/services/chat.tsx
mk_int
called by 19
src/parallax/metal/paged_attention/kernel.py

Shape

Method 456
Function 373
Class 101
Interface 56
Route 13

Languages

Python82%
TypeScript18%

Modules by API surface

src/scheduling/layer_allocation.py35 symbols
src/parallax/server/http_server.py31 symbols
src/parallax/p2p/server.py30 symbols
src/parallax/server/radix_cache.py28 symbols
src/scheduling/node.py27 symbols
src/scheduling/scheduler.py24 symbols
src/parallax/server/request.py22 symbols
src/parallax/server/node_chat_http_server.py20 symbols
src/parallax/server/paged_kv_cache.py19 symbols
src/parallax/server/executor/base_executor.py19 symbols
src/backend/server/scheduler_manage.py18 symbols
src/parallax/server/kv_cache.py17 symbols

For agents

$ claude mcp add parallax \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact