aphelion-core
Core library for the Aphelion Framework - a unified frontend for AI model development in Rust.
Overview
aphelion-core provides the foundational APIs for building AI pipelines:
- BuildGraph - Directed acyclic graph for model architecture with deterministic SHA-256 hashing
- BuildPipeline - Composable pipeline stages for training, inference, and deployment
- ModelConfig - Type-safe configuration with parameter validation and versioning
- Backend - Hardware abstraction trait for CPU, GPU, and accelerators
- Diagnostics - Structured tracing and event logging
Installation
[dependencies]
aphelion-core = "1.2"
serde_json = "1.0" # Required for parameter values
Optional Features
[dependencies]
aphelion-core = { version = "1.2", features = ["rust-ai-core", "tritter-accel", "tokio"] }
| Feature | Description |
|---|---|
rust-ai-core |
Memory tracking, device detection, dtype utilities via rust-ai-core |
tritter-accel |
BitNet b1.58 ternary ops, VSA gradient compression via tritter-accel |
cuda |
CUDA GPU support (requires rust-ai-core) |
burn |
Burn deep learning framework backend |
cubecl |
CubeCL GPU compute backend |
tokio |
Async pipeline execution |
python |
Python bindings via PyO3 (builds aphelion-framework wheel) |
Quick Start
use aphelion_core::prelude::*;
use aphelion_core::config::ModelConfig;
use aphelion_core::backend::NullBackend;
use aphelion_core::diagnostics::InMemoryTraceSink;
use aphelion_core::graph::BuildGraph;
use aphelion_core::pipeline::{BuildContext, BuildPipeline};
// Create model configuration
let config = ModelConfig::new("transformer", "1.0.0")
.with_param("d_model", serde_json::json!(512))
.with_param("n_heads", serde_json::json!(8));
// Build graph
let mut graph = BuildGraph::default();
let node = graph.add_node("encoder", config);
// Execute pipeline
let backend = NullBackend::cpu();
let trace = InMemoryTraceSink::new();
let ctx = BuildContext::new(&backend, &trace);
let pipeline = BuildPipeline::standard();
let result = pipeline.execute(&ctx, graph).unwrap();
println!("Hash: {}", result.stable_hash());
Core Modules
config - Model Configuration
use aphelion_core::config::ModelConfig;
let config = ModelConfig::new("llama", "2.0.0")
.with_param("hidden_size", serde_json::json!(4096))
.with_param("num_layers", serde_json::json!(32));
// Type-safe retrieval
let hidden: u32 = config.param("hidden_size")?;
let layers: u32 = config.param_or("num_layers", 12)?;
graph - Build Graph
use aphelion_core::graph::BuildGraph;
let mut graph = BuildGraph::default();
let input = graph.add_node("input", config.clone());
let hidden = graph.add_node("hidden", config.clone());
graph.add_edge(input, hidden);
// Deterministic hash
let hash = graph.stable_hash();
pipeline - Pipeline Execution
use aphelion_core::pipeline::{BuildPipeline, ValidationStage, HashingStage};
let pipeline = BuildPipeline::new()
.with_stage(Box::new(ValidationStage))
.with_stage(Box::new(HashingStage))
.with_pre_hook(|ctx| {
println!("Starting on {}", ctx.backend.name());
Ok(())
});
let result = pipeline.execute(&ctx, graph)?;
backend - Hardware Abstraction
use aphelion_core::backend::{Backend, NullBackend, DeviceCapabilities};
// Use null backend for testing
let backend = NullBackend::cpu();
// Implement custom backend
impl Backend for MyGpuBackend {
fn name(&self) -> &str { "my_gpu" }
fn device(&self) -> &str { "cuda:0" }
fn capabilities(&self) -> DeviceCapabilities { /* ... */ }
fn is_available(&self) -> bool { true }
fn initialize(&mut self) -> AphelionResult<()> { Ok(()) }
fn shutdown(&mut self) -> AphelionResult<()> { Ok(()) }
}
diagnostics - Tracing
use aphelion_core::diagnostics::{InMemoryTraceSink, TraceSinkExt};
let trace = InMemoryTraceSink::new();
trace.info("model.init", "Initializing model");
trace.warn("config", "Deprecated parameter");
let json = trace.to_json();
Ecosystem Integration
aphelion-core is part of the rust-ai ecosystem:
- rust-ai-core - Memory tracking, device detection
- tritter-accel - Ternary acceleration
- Candle - Tensor operations
See the framework README for full ecosystem documentation.
License
MIT License - see LICENSE
Metadata
Release files for aphelion-framework 1.2.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aphelion_framework-1.2.10.tar.gz | 133.7 kB | With provenance | Details for aphelion_framework-1.2.10.tar.gz |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aphelion_framework-1.2.10-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details for aphelion_framework-1.2.10-cp310-abi3-win_amd64.whl |
| aphelion_framework-1.2.10-cp310-abi3-manylinux_2_34_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.34+ x86-64 | Details for aphelion_framework-1.2.10-cp310-abi3-manylinux_2_34_x86_64.whl |
| aphelion_framework-1.2.10-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details for aphelion_framework-1.2.10-cp310-abi3-macosx_11_0_arm64.whl |
Total release size: 1.5 MB
Release files / aphelion_framework-1.2.10.tar.gz
| Download URL | aphelion_framework-1.2.10.tar.gz |
|---|---|
| Size | 133.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3ca7cd0cbbbc42dfa14ce941282235754053378e989063ec6cec0bd1994267c6
|
|
BLAKE2b-256 checksum How to use checksums |
260dff82cc2eaddde9d180ab90529f68fbe15b3b98b808506003c21cf31dadb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logRelease files / aphelion_framework-1.2.10-cp310-abi3-win_amd64.whl
| Download URL | aphelion_framework-1.2.10-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 392.2 kB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a36c3fdcea0cd7a1af0937ad418bc8c14d22cad011ec41e87bb010bd163819a7
|
|
BLAKE2b-256 checksum How to use checksums |
fce72981ea8d63d7b9fc9a635d6cd9e399d95cf8774f755855c41e48dd35670d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logRelease files / aphelion_framework-1.2.10-cp310-abi3-manylinux_2_34_x86_64.whl
| Download URL | aphelion_framework-1.2.10-cp310-abi3-manylinux_2_34_x86_64.whl |
|---|---|
| Size | 491.4 kB |
| Tags | CPython 3.10 Linux glibc 2.34+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a40008c5e744cc6ca78bd0593c0d771002666d3700065e2e9f470985da9b6482
|
|
BLAKE2b-256 checksum How to use checksums |
3e584dc1dd472c1b7525856c2027c676551b80266186978999aed862f8780f58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logRelease files / aphelion_framework-1.2.10-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | aphelion_framework-1.2.10-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 447.6 kB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7dfeaef0e1fe65f062520fbaea05f4ff2a9d7f58819b496896f1e387568e6a7e
|
|
BLAKE2b-256 checksum How to use checksums |
bc739c9cdb0d85195e8406046bcb82b7b552f29529fc3e09694f388ce29cf76f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logSecurity for aphelion-framework 1.2.10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for aphelion_framework-1.2.10.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 29, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.