xybrid-core 0.1.0-rc4

Core runtime for hybrid cloud-edge AI inference: model execution, pipeline orchestration, and routing primitives.
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

//! Prelude module for convenient imports.
//!
//! This module re-exports the most commonly used types and traits from xybrid-core,
//! allowing users to quickly get started with a single import.
//!
//! # Example
//!
//! ```rust,ignore
//! use xybrid_core::prelude::*;
//!
//! // Now you have access to common types
//! let input = Envelope::from_text("Hello, world!");
//! let mut executor = TemplateExecutor::with_base_path("models/tts");
//! let output = executor.execute(&metadata, &input)?;
//! ```
//!
//! # What's Included
//!
//! ## Core Types
//! - [`Envelope`], [`EnvelopeKind`] - Data containers for pipeline stages
//! - [`ModelMetadata`] - Model configuration from `model_metadata.json`
//! - [`TemplateExecutor`] - Metadata-driven model inference
//!
//! ## Error Types
//! - [`XybridError`], [`XybridResult`] - Unified public API errors (preferred)
//! - [`InferenceError`], [`PipelineError`] - Specific error categories
//! - [`AdapterError`], [`AdapterResult`] - Legacy adapter errors
//!
//! ## Execution
//! - [`ExecutionTemplate`] - Execution mode configuration
//! - [`PreprocessingStep`], [`PostprocessingStep`] - Pipeline step definitions

// ============================================================================
// Core Data Types
// ============================================================================

pub use crate::ir::{Envelope, EnvelopeKind};

// ============================================================================
// Model Metadata & Execution Templates
// ============================================================================

pub use crate::execution::{
    ExecutionTemplate, ModelMetadata, PostprocessingStep, PreprocessingStep, TemplateExecutor,
};

// ============================================================================
// Error Types
// ============================================================================

// Unified error types (preferred for public API)
pub use crate::error::{InferenceError, PipelineError, XybridError, XybridResult};

// Legacy error types (still used internally by adapters)
pub use crate::runtime_adapter::{AdapterError, AdapterResult};

// ============================================================================
// Context & Metrics
// ============================================================================

pub use crate::context::{DeviceMetrics, StageDescriptor};

// ============================================================================
// Device Detection
// ============================================================================

pub use crate::device::HardwareCapabilities;

// ============================================================================
// Cache Provider
// ============================================================================

pub use crate::cache_provider::{CacheProvider, FilesystemCacheProvider, NoopCacheProvider};