Struct BrickTuner 

pub struct BrickTuner { /* private fields */ }

ML-based ComputeBrick tuner ensemble.

Combines three models for comprehensive recommendations:

• ThroughputRegressor: Predicts tok/s
• KernelClassifier: Selects best kernel
• BottleneckClassifier: Identifies performance bottleneck

Implementations

impl BrickTuner

pub fn to_json(&self) -> Result<String, TunerError>

Serialize to JSON

pub fn from_json(json: &str) -> Result<Self, TunerError>

Deserialize from JSON

pub fn cache_path() -> PathBuf

Get the default cache path for tuner models.

Returns ~/.cache/trueno/tuner_model_v{VERSION}.apr

pub fn load_or_default() -> Self

Load tuner from cache or create new with defaults.

This is the recommended way to create a BrickTuner for production use. It will:

1. Check for cached model at ~/.cache/trueno/tuner_model_v{VERSION}.apr
2. Load if exists and version matches
3. Create new with defaults if not found or version mismatch

pub fn save_apr<P: AsRef<Path>>(&self, path: P) -> Result<(), TunerError>

Save tuner model to .apr file.

APR1 format (uncompressed):

• 4-byte magic: “APR1”
• 4-byte metadata_len: u32 LE
• JSON metadata
• 4-byte CRC32: checksum

pub fn load_apr<P: AsRef<Path>>(path: P) -> Result<Self, TunerError>

Load tuner model from .apr file.

pub fn save_to_cache(&self) -> Result<(), TunerError>

Save to default cache path.

impl BrickTuner

pub fn print_recommendation(&self, rec: &TunerRecommendation)

Print recommendations to console (TUI-friendly)

pub fn render_panel(&self, rec: &TunerRecommendation) -> Vec<String>

Render recommendation as TUI panel lines (for cbtop integration)

Returns a vector of strings that can be rendered in a TUI widget. Each line is formatted for fixed-width display (width=61 chars).

pub fn render_compact(&self, rec: &TunerRecommendation) -> String

Render compact recommendation (single line for status bar)

pub fn render_comparison( &self, rec: &TunerRecommendation, actual_tps: f32, ) -> Vec<String>

Render prediction vs actual comparison

impl BrickTuner

pub const VERSION: &'static str = "1.0.0"

Model version

pub fn new() -> Self

Create a new tuner with default models

pub fn version(&self) -> &str

Get the model version string

pub fn throughput_mape(&self) -> f32

Get the throughput regressor’s MAPE (Mean Absolute Percentage Error)

pub fn throughput_sample_count(&self) -> usize

Get the number of training samples used

pub fn recommend(&self, features: &TunerFeatures) -> TunerRecommendation

Get comprehensive tuning recommendation

pub fn suggest_experiments( &self, features: &TunerFeatures, bottleneck: &BottleneckPrediction, ) -> Vec<ExperimentSuggestion>

Suggest experiments based on current bottleneck

pub fn train(&mut self, data: &[(TunerFeatures, f32)]) -> Result<(), TunerError>

Train all models on labeled data

impl BrickTuner

pub fn with_pretrained() -> Self

Create tuner with pre-trained weights from benchmark corpus

This is the recommended initialization for production use. Pre-trained on 10,000+ samples from CI benchmark runs.

pub fn calibrate(&mut self) -> Result<CalibrationResult, TunerError>

Run first-run calibration to tune for local hardware

Runs micro-benchmarks and trains a local model. Typically completes in < 30 seconds.

pub fn online_learner(&self) -> OnlineLearner

Create an online learner for continuous improvement

pub fn apply_online_updates(&mut self, learner: &OnlineLearner)

Update tuner with observations from online learner

pub fn kernel_bandit(&self) -> KernelBandit

Create a bandit for kernel exploration

pub fn recommend_kernel_with_exploration( &self, features: &TunerFeatures, bandit: &KernelBandit, explore_prob: f32, ) -> KernelRecommendation

Get kernel recommendation using bandit (exploration mode)

Trait Implementations

impl Clone for BrickTuner

fn clone(&self) -> BrickTuner

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BrickTuner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BrickTuner

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BrickTuner

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BrickTuner

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.