archx 2.1.0

High-performance CPU/GPU adaptive optimization library with SIMD and Multithreading
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# ArchX Sovereign v2.1 — Hybrid Acceleration Engine

### Hybrid by Intelligence. Sovereign by Design.


[![Crates.io](https://img.shields.io/crates/v/archx.svg)](https://crates.io/crates/archx)
[![Documentation](https://docs.rs/archx/badge.svg)](https://docs.rs/archx)
![v2.1 Sovereign](https://img.shields.io/badge/release-v2.1--hybrid--sovereign-purple)
![Performance](https://img.shields.io/badge/speed-hybrid--optimized-orange)

**ArchX v2.1** is a high-performance acceleration framework that gives your Rust applications "Sovereignty of Execution." It doesn't just run code; it analyzes your hardware (CPU, iGPU, dGPU) and adaptively chooses the optimal parallel path.

---

## 🚀 What's New in v2.1 (Sovereign Hybrid)


### 1. Hybrid Device Discovery

The new `DeviceManager` distinguishes between **Integrated GPUs (iGPU)** like AMD Vega / Intel UHD and **Dedicated GPUs (dGPU)**. It maps shared memory topology to ensure zero-copy overhead where possible.

### 2. Cooperative Hybrid Dispatch

Large workloads (e.g., 10M+ elements) are now split between the GPU (70%) and CPU (30%) automatically. Result reconciliation is handled by the `HybridScheduler` with 100% safe fallback to SIMD if backends disappear.

### 3. Sovereign Policy Engine

Move beyond manual thread counts. Use high-level intent:
- `Policy::SmartAuto`: Dynamic CPU load & memory pressure analysis.
- `Policy::Performance`: Aggressive CPU+GPU cooperative scaling.
- `Policy::PowerSaving`: Efficient SIMD on P-cores with GPU idling.

### 4. Profiler v2.1 (Energy & Backend Tracking)

The upgraded profiler provides precise backend attribution (Vulkan/OpenCL/SIMD) and estimates energy consumption per task.

---

## 🏗️ Quick Start: Sovereign API


```rust
use archx::{archx, Policy};

fn main() {
    let a = vec![1.0; 10_000_000];
    let b = vec![2.0; 10_000_000];
    let mut out = vec![0.0; 10_000_000];

    archx()
        .policy(Policy::SmartAuto)
        .enable_gpu(true)
        .enable_hybrid(true)      // CPU + GPU Cooperative execution
        .profile(true)            // Detailed v2.1 analytics
        .execute(&a, &b, &mut out);
}
```

---

## 📊 v2.1 Capability Matrix


| Feature | ArchX v2.0 | ArchX v2.1 Sovereign Hybrid |
| :--- | :--- | :--- |
| **Execution** | Single Device | **CPU + GPU Cooperative** |
| **GPU Support** | dGPU / Generic | **iGPU (Vega/UHD) Optimized** |
| **Dispatch** | Strategy-based | **Policy-driven AI (SmartAuto)** |
| **Profiling** | Time-based | **Energy & Backend Attribution** |
| **WASM** | Static Fallback | **WASM SafeMode v2.1** |

---

## 🤝 The Sovereign Identity


ArchX v2.1 is designed for serious system-level acceleration. 
- **No Hard Dependencies**: Vulkan/OpenCL are dynamically loaded.
- **Panic-Free Policy**: If a driver fails, execution falls back in 1ms to CPU.
- **Enterprise Grade**: Ready for Tauri, WASM, and high-frequency CLI tools.

---

## 🧪 Bulk Verification


**Check Compilation:**
```bash
cargo check --examples
```

**Run All (PowerShell):**
```powershell
Get-ChildItem examples/*.rs | ForEach-Object { $name = $_.BaseName; cargo run --example $name }
```

---
Designed with love by **Codevora Studio**.
MIT / Apache-2.0 © 2026 Codevora Studio