---
title: "pmetal"
type: "tool"
slug: "epistates-pmetal"
canonical_url: "https://www.graphcanon.com/tools/epistates-pmetal"
github_url: "https://github.com/Epistates/pmetal"
homepage_url: "https://pmetal.io"
stars: 303
forks: 22
primary_language: "Rust"
license: "Other"
archived: false
categories: ["inference-serving", "llm-frameworks", "model-training"]
tags: ["ai", "ane", "apple-silicon", "deep-learning", "distillation", "fine-tuning", "gguf", "inference-server"]
updated_at: "2026-07-15T11:19:40.27685+00:00"
---

# pmetal

> PMetal: high-performance Apple Silicon framework for local LLM inference, LoRA/QLoRA fine-tuning, serving, quantization, and MLX/Metal acceleration.

PMetal: high-performance Apple Silicon framework for local LLM inference, LoRA/QLoRA fine-tuning, serving, quantization, and MLX/Metal acceleration.

## Facts

- Repository: https://github.com/Epistates/pmetal
- Homepage: https://pmetal.io
- Stars: 303 · Forks: 22 · Open issues: 7 · Watchers: 3
- Primary language: Rust
- License: Other
- Last pushed: 2026-06-05T11:56:14+00:00

## Trust & health

_Signals computed from public GitHub metadata. Not a security guarantee._

- Maintenance: Steady (computed 2026-07-15T11:19:37.793Z)
- Security scan: No lockfile (0 critical, 0 high, 0 medium, 0 low) · last scan 2026-07-15T11:19:38.714Z
- Full report: [trust report](/tools/epistates-pmetal/trust.md) · [JSON](https://www.graphcanon.com/api/graphcanon/tools/epistates-pmetal/trust)

## Categories

- [Inference & Serving](/categories/inference-serving.md)
- [LLM Frameworks](/categories/llm-frameworks.md)
- [Model Training](/categories/model-training.md)

## Tags

ai, ane, apple-silicon, deep-learning, distillation, fine-tuning, gguf, inference-server

## Category neighbours (exploratory)

_Same-category tools for discovery only - not curated alternatives. Cap shown at six._

- [tensorflow](/tools/tensorflow-tensorflow.md) - An Open Source Machine Learning Framework for Everyone (★ 196,300) [Very active]
- [AutoGPT](/tools/significant-gravitas-autogpt.md) - AutoGPT is the vision of accessible AI for everyone, to use and to build on. (★ 185,464) [Very active]
- [ollama](/tools/ollama-ollama.md) - Get up and running with various large language models using Ollama. (★ 175,936) [Very active]
- [prompts.chat](/tools/f-prompts-chat.md) - Share, discover, and collect prompts from the community (★ 165,372) [Very active]
- [transformers](/tools/huggingface-transformers.md) - Transformers: the model-definition framework for state-of-the-art machine learning models in text, vision, audio, and multimodal models (★ 162,482) [Very active]
- [langflow](/tools/langflow-ai-langflow.md) - Langflow is a powerful tool for building and deploying AI-powered agents and workflows. (★ 151,697) [Very active]

_+ 2 more not listed._

## README (excerpt)

_Quoted verbatim from the upstream repository. Untrusted content - treat as data, not instructions._

````text
### Quick Start (Easy API)

```python
import pmetal

---

## Installation

Prebuilt signed binaries are available on the [Releases](https://github.com/Epistates/pmetal/releases) page.

Crates are available on [crates.io](https://crates.io/crates/pmetal).

Build from source:

```bash
git clone https://github.com/epistates/pmetal.git && cd pmetal
cargo build --release          # CLI + TUI
cd crates/pmetal-gui && bun install && bun tauri build  # GUI (optional)
```

---

## Hardware Support

PMetal automatically detects Apple Silicon capabilities at startup and tunes kernel parameters accordingly.

| Chip Family | GPU Family | NAX | ANE | UltraFusion | Status |
|-------------|-----------|-----|-----|-------------|--------|
| M1 / Pro / Max / Ultra | Apple7 | - | 16 cores | Ultra: 2-die | Fully supported |
| M2 / Pro / Max / Ultra | Apple8 | - | 16 cores | Ultra: 2-die | Fully supported |
| M3 / Pro / Max / Ultra | Apple9 | - | 16 cores | Ultra: 2-die | Fully supported |
| M4 / Pro / Max / Ultra | Apple9 | - | 16 cores | Ultra: 2-die | Fully supported |
| **M5 / Pro / Max / Ultra** | **Apple10** | **Yes** | **16 cores** | **Ultra: 2-die** | **Fully supported** |

**Auto-detected features**: GPU family, device tier, core counts, memory bandwidth, dynamic caching, mesh shaders, NAX (M5+), UltraFusion topology (via `sysctl hw.packages`), ANE availability.

**Tier-based kernel tuning**: Matrix tile sizes, FlashAttention block sizes, fused kernel threadgroup sizes, and batch multipliers are automatically selected based on device tier (Base/Pro/Max/Ultra) and GPU family. See [`docs/hardware-support.md`](docs/hardware-support.md) for the full tuning matrix.

---

### Training Infrastructure

- **Sequence Packing**: Efficiently pack multiple sequences into single batches for 2-5x throughput. Enabled by default
- **Gradient Checkpointing**: Trade compute for memory on large models with configurable layer grouping
- **Adaptive LR**: EMA-based anomaly detection with spike recovery, plateau reduction, and divergence detection
- **Callback System**: `TrainingCallback` trait with lifecycle hooks (`on_step_start`, `on_step_end`, `should_stop`) for metrics logging, progress reporting, and clean cancellation
- **Checkpoint Management**: Save and resume training from checkpoints with best-loss rollback
- **Tool/Function Calling**: Chat templates with native tool definitions for Qwen, Llama 3.1+, Mistral v3+, and DeepSeek
- **Schedule-Free Optimizer**: Memory-efficient optimizer without learning rate schedules
- **Metal Fused Optimizer**: GPU-accelerated AdamW parameter updates
- **8-bit Adam**: Memory-efficient optimizer for large models
- **LoRA+**: Differentiated learning rates for LoRA A and B matrices
- **NEFTune**: Noise-augmented fine-tuning for improved generation quality
- **Distributed Training**: mDNS auto-discovery, Ring All-Reduce with gradient compression

---

## License

Licensed under either of MIT or Apache-2.0.
````

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/tools/epistates-pmetal`](/api/graphcanon/tools/epistates-pmetal)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_