Instructions to use TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4 with MLX:

# Make sure mlx-vlm is installed
# pip install --upgrade mlx-vlm

from mlx_vlm import load, generate
from mlx_vlm.prompt_utils import apply_chat_template
from mlx_vlm.utils import load_config

# Load the model
model, processor = load("TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4")
config = load_config("TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4")

# Prepare input
image = ["http://images.cocodataset.org/val2017/000000039769.jpg"]
prompt = "Describe this image."

# Apply chat template
formatted_prompt = apply_chat_template(
    processor, config, prompt, num_images=1
)

# Generate output
output = generate(model, processor, formatted_prompt, image)
print(output)

Notebooks
Google Colab
Kaggle
Local Apps Settings
LM Studio

How to use TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4 with Pi:

Start the MLX server

# Install MLX LM:
uv tool install mlx-lm
# Start a local OpenAI-compatible server:
mlx_lm.server --model "TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4"

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "mlx-lm": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Hermes Agent

How to use TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4 with Hermes Agent:

Start the MLX server

# Install MLX LM:
uv tool install mlx-lm
# Start a local OpenAI-compatible server:
mlx_lm.server --model "TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4"

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4 with OpenClaw:

Start the MLX server

# Install MLX LM:
uv tool install mlx-lm
# Start a local OpenAI-compatible server:
mlx_lm.server --model "TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4"

Configure OpenClaw

# Install OpenClaw:
npm install -g openclaw@latest
# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "TheCluster/Qwen3.5-35B-A3B-Heretic-MLX-nvfp4" \
  --custom-provider-id mlx-lm \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

Run OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

TheCluster commited on Feb 26

Commit

f8dbe88

verified ·

1 Parent(s): 14759fb

Update README.md

Browse files

Files changed (1) hide show

README.md +68 -3

README.md CHANGED Viewed

@@ -1,3 +1,68 @@
----
-license: mit
----

+---
+license: apache-2.0
+license_link: https://huggingface.co/Qwen/Qwen3.5-35B-A3B/blob/main/LICENSE
+language:
+- en
+- zh
+base_model:
+- brayniac/Qwen3.5-35B-A3B-heretic
+library_name: mlx
+tags:
+- heretic
+- uncensored
+- unrestricted
+- decensored
+- abliterated
+- nvfp4
+pipeline_tag: image-text-to-text
+---
+<div align="center"><img width="400px" src="https://qianwen-res.oss-accelerate.aliyuncs.com/logo_qwen3.5.png"></div>
+# Qwen3.5-35B-A3B Heretic MLX nvfp4
+### This is a decensored version of [Qwen/Qwen3.5-35B-A3B](https://huggingface.co/Qwen/Qwen3.5-35B-A3B), made using [Heretic](https://github.com/p-e-w/heretic) v1.2.0
+Also this model includes a fixed template for correctly calling tools in LM Studio.
+## Performance
+| Metric | This model | Original model (a model) |
+| :----- | :--------: | :---------------------------: |
+| **KL divergence** | 0.0825 | 0 *(by definition)* |
+| **Refusals** | 5/100 | 92/100 |
+## Abliteration parameters
+| Parameter | Value |
+| :-------- | :---: |
+| **direction_index** | 20.06 |
+| **linear_attn.out_proj.max_weight** | 0.93 |
+| **linear_attn.out_proj.max_weight_position** | 37.63 |
+| **linear_attn.out_proj.min_weight** | 0.71 |
+| **linear_attn.out_proj.min_weight_distance** | 4.94 |
+| **moe_experts.down_proj.max_weight** | 1.18 |
+| **moe_experts.down_proj.max_weight_position** | 23.68 |
+| **moe_experts.down_proj.min_weight** | 0.86 |
+| **moe_experts.down_proj.min_weight_distance** | 5.48 |
+| **shared_expert.down_proj.max_weight** | 1.33 |
+| **shared_expert.down_proj.max_weight_position** | 36.08 |
+| **shared_expert.down_proj.min_weight** | 0.70 |
+| **shared_expert.down_proj.min_weight_distance** | 17.75 |
+| **attn.o_proj.max_weight** | 0.83 |
+| **attn.o_proj.max_weight_position** | 35.00 |
+| **attn.o_proj.min_weight** | 0.06 |
+| **attn.o_proj.min_weight_distance** | 15.22 |
+#### Sampling Parameters:
+   - We suggest using the following sets of sampling parameters depending on the mode and task type:
+     - **Thinking mode for general tasks**:
+       `temperature=1.0`, `top_p=0.95`, `top_k=20`, `min_p=0.0`, `presence_penalty=1.5`, `repetition_penalty=1.0`
+     - **Thinking mode for precise coding tasks (e.g., WebDev)**:
+       `temperature=0.6`, `top_p=0.95`, `top_k=20`, `min_p=0.0`, `presence_penalty=0.0`, `repetition_penalty=1.0`
+     - **Instruct (or non-thinking) mode for general tasks**:
+       `temperature=0.7`, `top_p=0.8`, `top_k=20`, `min_p=0.0`, `presence_penalty=1.5`, `repetition_penalty=1.0`
+     - **Instruct (or non-thinking) mode for reasoning tasks**:
+       `temperature=1.0`, `top_p=1.0`, `top_k=40`, `min_p=0.0`, `presence_penalty=2.0`, `repetition_penalty=1.0`
+   - For supported frameworks, you can adjust the `presence_penalty` parameter between 0 and 2 to reduce endless repetitions. However, using a higher value may occasionally result in language mixing and a slight decrease in model performance.
+-----
+### Source
+This model was converted to MLX format from [`brayniac/Qwen3.5-35B-A3B-heretic`](https://huggingface.co/brayniac/Qwen3.5-35B-A3B-heretic) using mlx-vlm version **0.3.12**.