lx-ai-core 0.0.1__tar.gz

lx_ai_core-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AG-Lux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lx_ai_core-0.0.1/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: lx-ai-core
+Version: 0.0.1
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Requires-Dist: pydantic>=2.10
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pytest>=8.3 ; extra == 'dev'
+Requires-Dist: numpy>=2.2 ; extra == 'dev'
+Requires-Dist: pillow>=11.0 ; extra == 'dev'
+Requires-Dist: torch>=2.5,<3 ; extra == 'dev'
+Requires-Dist: make>=0.1.6.post2 ; extra == 'dev'
+Requires-Dist: maturin>=1.13.1 ; extra == 'dev'
+Requires-Dist: ziglang>=0.16.0 ; extra == 'dev'
+Requires-Dist: numpy>=2.2 ; extra == 'torch'
+Requires-Dist: pillow>=11.0 ; extra == 'torch'
+Requires-Dist: torch>=2.5,<3 ; extra == 'torch'
+Provides-Extra: dev
+Provides-Extra: torch
+License-File: LICENSE
+Summary: Standalone local AI runtime core for LX medical model workflows.
+Author: WG Lux
+Requires-Python: >=3.12, <3.13
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# lx-active-learning
+
+Standalone AI runtime and deployment core for the LX ecosystem.
+
+This is a inference module that provides active learning functionalities on data imported into endoreg-db. It provides optimizations for various types of models and will be ready to host models and efficiently run them while actively updating their weights if that is possible. 
+
+This package intentionally contains no Django models, no Celery tasks, no direct
+database access, and no network transfer logic. Integrating callers such as
+`endoreg-db` own storage, provenance persistence, queueing, and security policy.
+

lx_ai_core-0.0.1/README.md

@@ -0,0 +1,9 @@
+# lx-active-learning
+
+Standalone AI runtime and deployment core for the LX ecosystem.
+
+This is a inference module that provides active learning functionalities on data imported into endoreg-db. It provides optimizations for various types of models and will be ready to host models and efficiently run them while actively updating their weights if that is possible. 
+
+This package intentionally contains no Django models, no Celery tasks, no direct
+database access, and no network transfer logic. Integrating callers such as
+`endoreg-db` own storage, provenance persistence, queueing, and security policy.

lx_ai_core-0.0.1/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "lx-ai-core"
+version = "0.0.1"
+description = "Standalone local AI runtime core for LX medical model workflows."
+readme = "README.md"
+requires-python = ">=3.12,<3.13"
+authors = [
+  { name = "WG Lux" },
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Medical Science Apps.",
+]
+dependencies = [
+  "pydantic>=2.10",
+  "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+torch = [
+  "numpy>=2.2",
+  "pillow>=11.0",
+  "torch>=2.5,<3",
+]
+
+dev = [
+  "pytest>=8.3",
+  "numpy>=2.2",
+  "pillow>=11.0",
+  "torch>=2.5,<3",
+  "make>=0.1.6.post2",
+  "maturin>=1.13.1",
+  "ziglang>=0.16.0",
+]
+
+[project.scripts]
+lx-ai-core = "lx_ai_core.cli:main"
+
+[build-system]
+requires = ["maturin>=1.7,<2"]
+build-backend = "maturin"
+
+[tool.maturin]
+manifest-path = "rust/lx_ai_core_native/Cargo.toml"
+module-name = "lx_ai_core._native"
+bindings = "pyo3"
+python-source = "src"
+features = ["pyo3/extension-module"]
+include = [
+  { path = "LICENSE", format = "sdist" },
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+addopts = "-q"

lx_ai_core-0.0.1/rust/lx_ai_core_native/Cargo.lock

@@ -0,0 +1,180 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "lx_ai_core_native"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f402062616ab18202ae8319da13fa4279883a2b8a9d9f83f20dbade813ce1884"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b14b5775b5ff446dd1056212d778012cbe8a0fbffd368029fd9e25b514479c38"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ab5bcf04a2cdcbb50c7d6105de943f543f9ed92af55818fd17b660390fc8636"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fd24d897903a9e6d80b968368a34e1525aeb719d568dba8b3d4bfa5dc67d453"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.22.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36c011a03ba1e50152b4b394b479826cad97e7a21eb52df179cd91ac411cbfbe"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"

lx_ai_core-0.0.1/rust/lx_ai_core_native/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "lx_ai_core_native"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+name = "lx_ai_core_native"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.22", features = ["extension-module"] }

lx_ai_core-0.0.1/rust/lx_ai_core_native/src/lib.rs

@@ -0,0 +1,94 @@
+use pyo3::prelude::*;
+
+#[pyfunction]
+#[pyo3(signature = (values, threshold, min_length=None))]
+fn threshold_runs(values: Vec<f64>, threshold: f64, min_length: Option<usize>) -> PyResult<Vec<(usize, usize)>> {
+    let min_len = min_length.unwrap_or(1).max(1);
+    let mut runs: Vec<(usize, usize)> = Vec::new();
+    let mut start: Option<usize> = None;
+
+    for (index, value) in values.iter().enumerate() {
+        if *value >= threshold {
+            if start.is_none() {
+                start = Some(index);
+            }
+        } else if let Some(run_start) = start {
+            let end = index - 1;
+            if end - run_start + 1 >= min_len {
+                runs.push((run_start, end));
+            }
+            start = None;
+        }
+    }
+
+    if let Some(run_start) = start {
+        let end = values.len() - 1;
+        if end - run_start + 1 >= min_len {
+            runs.push((run_start, end));
+        }
+    }
+
+    Ok(runs)
+}
+
+#[pyfunction]
+fn smooth_scores(values: Vec<f64>, window: usize) -> PyResult<Vec<f64>> {
+    if window <= 1 {
+        return Ok(values);
+    }
+    let radius = window / 2;
+    let mut out: Vec<f64> = Vec::with_capacity(values.len());
+    for index in 0..values.len() {
+        let start = index.saturating_sub(radius);
+        let end = (index + radius + 1).min(values.len());
+        let mut total = 0.0;
+        for value in values[start..end].iter() {
+            total += *value;
+        }
+        out.push(total / ((end - start) as f64));
+    }
+    Ok(out)
+}
+
+#[pyfunction]
+fn mask_rle_encode(mask: Vec<u8>) -> PyResult<Vec<usize>> {
+    let mut counts: Vec<usize> = Vec::new();
+    let mut current: u8 = 0;
+    let mut run_len: usize = 0;
+
+    for raw in mask.iter() {
+        let value = if *raw == 0 { 0 } else { 1 };
+        if value == current {
+            run_len += 1;
+        } else {
+            counts.push(run_len);
+            current = value;
+            run_len = 1;
+        }
+    }
+
+    counts.push(run_len);
+    Ok(counts)
+}
+
+#[pyfunction]
+fn mask_rle_decode(counts: Vec<usize>) -> PyResult<Vec<u8>> {
+    let mut out: Vec<u8> = Vec::new();
+    let mut value: u8 = 0;
+    for count in counts.iter() {
+        for _ in 0..*count {
+            out.push(value);
+        }
+        value = 1 - value;
+    }
+    Ok(out)
+}
+
+#[pymodule]
+fn _native(m: &Bound<'_, PyModule>) -> PyResult<()> {
+    m.add_function(wrap_pyfunction!(threshold_runs, m)?)?;
+    m.add_function(wrap_pyfunction!(smooth_scores, m)?)?;
+    m.add_function(wrap_pyfunction!(mask_rle_encode, m)?)?;
+    m.add_function(wrap_pyfunction!(mask_rle_decode, m)?)?;
+    Ok(())
+}

lx_ai_core-0.0.1/src/lx_ai_core/__init__.py

@@ -0,0 +1,131 @@
+from importlib.metadata import PackageNotFoundError, version as _package_version
+
+from lx_ai_core.contracts import (
+    BackendName,
+    InferenceInput,
+    InferenceRequest,
+    InferenceResult,
+    LatentMetric,
+    LatentNormalization,
+    LatentSpaceSpec,
+    LatentVector,
+    MaskArtifact,
+    Modality,
+    ModelSpec,
+    RunMetrics,
+    Score,
+    ScoreVector,
+    TaskKind,
+    TemporalSegment,
+)
+from lx_ai_core.active_learning import (
+    ActiveLearningCandidate,
+    ActiveLearningConfig,
+    ActiveLearningSelection,
+    ScoredActiveLearningCandidate,
+    select_active_learning_candidates,
+    select_active_learning_frame_indices,
+)
+from lx_ai_core.latent import (
+    build_latent_vectors,
+    l2_normalize,
+    latent_space_from_options,
+    mean_pool_latent_vectors,
+    metadata_sequence,
+    normalize_latent_rows,
+    validate_latent_rows,
+)
+from lx_ai_core.postprocessing import (
+    hysteresis_runs,
+    smooth_scores,
+    temporal_segments_from_scores,
+    threshold_runs,
+)
+from lx_ai_core.runtime import (
+    ModelCache,
+    ModelLoadError,
+    RuntimeRegistry,
+    UnsupportedBackendError,
+    UnsupportedTaskError,
+    default_registry,
+    run_inference,
+)
+from lx_ai_core.temporal import (
+    binary_markov_smooth_scores,
+    normalize_transition_matrix,
+    state_path_to_segments,
+    sticky_transition_matrix,
+    viterbi_decode_state_scores,
+)
+from lx_ai_core.training import (
+    TrainingArtifact,
+    TrainingArtifactKind,
+    TrainingDatasetManifest,
+    TrainingParameters,
+    TrainingRequest,
+    TrainingResult,
+    TrainingSample,
+    TrainingStatus,
+)
+
+try:
+    __version__ = _package_version("lx-ai-core")
+except PackageNotFoundError:
+    __version__ = "0.0.0+unknown"
+
+__all__ = [
+    "ActiveLearningCandidate",
+    "ActiveLearningConfig",
+    "ActiveLearningSelection",
+    "BackendName",
+    "InferenceInput",
+    "InferenceRequest",
+    "InferenceResult",
+    "LatentMetric",
+    "LatentNormalization",
+    "LatentSpaceSpec",
+    "LatentVector",
+    "MaskArtifact",
+    "ModelCache",
+    "ModelLoadError",
+    "Modality",
+    "ModelSpec",
+    "RunMetrics",
+    "RuntimeRegistry",
+    "ScoredActiveLearningCandidate",
+    "Score",
+    "ScoreVector",
+    "TaskKind",
+    "TemporalSegment",
+    "TrainingArtifact",
+    "TrainingArtifactKind",
+    "TrainingDatasetManifest",
+    "TrainingParameters",
+    "TrainingRequest",
+    "TrainingResult",
+    "TrainingSample",
+    "TrainingStatus",
+    "UnsupportedBackendError",
+    "UnsupportedTaskError",
+    "__version__",
+    "binary_markov_smooth_scores",
+    "build_latent_vectors",
+    "default_registry",
+    "hysteresis_runs",
+    "l2_normalize",
+    "latent_space_from_options",
+    "mean_pool_latent_vectors",
+    "metadata_sequence",
+    "normalize_transition_matrix",
+    "normalize_latent_rows",
+    "run_inference",
+    "select_active_learning_candidates",
+    "select_active_learning_frame_indices",
+    "smooth_scores",
+    "state_path_to_segments",
+    "sticky_transition_matrix",
+    "temporal_segments_from_scores",
+    "threshold_runs",
+    "validate_latent_rows",
+    "viterbi_decode_state_scores",
+]