How eukalpia/tensora works
Tensora is a native machine-learning runtime for Dart, exposing tensors and optional training and ONNX inference through a C ABI. The main workflow is a Dart application calling native entry points, which manage opaque handles and dispatch numerical work to CPU or optional LibTorch/ONNX implementations. Tensor shapes, storage, and device identity form shared runtime foundations. The README documents the public workflow and optional capabilities; source-index references and sampled headers support the native layers, but several backend implementations were not sampled, so their internal call details are not expanded.
Main entry points: c_api.cc Core entry points · dispatcher.cc Backend dispatcher · cpu_backend.cc CPU operations · training_bridge.h Training bridge
Components 19
Native API
- C ABI
native/include/tensora.h - Core entry points
native/src/c_api.cc - Inference entry points
native/src/inference/inference_c_api.cc - Training entry points
native/src/training/training_c_api.cc
Tensor Runtime
- Backend dispatcher
native/src/runtime/dispatcher.cc - Opaque handles
native/src/runtime/handle_registry.cc - Device codec
native/src/runtime/device_codec.cc - Shape validation
native/src/tensor/shape.cc - Tensor object
native/src/tensor/tensor.cc - Storage contract
native/src/memory/tensor_storage.h - CPU storage
native/src/memory/cpu_storage.cc
Compute Backends
- CPU operations
native/src/backends/cpu/cpu_backend.cc
Training
- Autograd
native/src/autograd/autograd.h - Training bridge
native/src/training/training_bridge.h - LibTorch backend
native/src/training/torch_backend.cc - Torch storage
native/src/training/torch_storage.cc
ONNX Inference
- Inference bridge
native/src/inference/inference_bridge.h - ONNX implementation
native/src/inference/inference_bridge_onnx.cc
Other components
- Dart application
Connections 22
- Dart application → C ABI: calls
README.md - C ABI → Core entry points: exports through
native/src/c_api.cc - Core entry points → Backend dispatcher: dispatches
native/src/c_api.cc - Core entry points → Opaque handles: manages handles
native/src/c_api.cc - Core entry points → Device codec: encodes devices
native/src/c_api.cc - Backend dispatcher → CPU operations: selects
native/src/runtime/dispatcher.cc - Backend dispatcher → LibTorch backend: selects
native/src/runtime/dispatcher.cc - CPU operations → Autograd: records gradients
native/src/backends/cpu/cpu_backend.cc - CPU operations → CPU storage: allocates
native/src/backends/cpu/cpu_backend.cc - Tensor object → Storage contract: owns storage
- CPU storage → Storage contract: implements
- Torch storage → Storage contract: implements
- Core entry points → Shape validation: validates shapes
native/src/c_api.cc - Training entry points → Training bridge: invokes
native/src/training/training_c_api.cc - Training entry points → Opaque handles: manages handles
native/src/training/training_c_api.cc - Training bridge → Autograd: uses
native/src/training/training_bridge.h - Training bridge → LibTorch backend: delegates
- LibTorch backend → Torch storage: uses
native/src/training/torch_storage.cc - Inference entry points → Inference bridge: invokes
native/src/inference/inference_c_api.cc - Inference entry points → Opaque handles: manages sessions
native/src/inference/inference_c_api.cc - Inference bridge → ONNX implementation: implemented by
native/src/inference/inference_bridge_onnx.cc - Inference bridge → ONNX implementation: stub alternative
native/src/inference/inference_bridge_onnx.cc