vitallens-core is the shared internal signal processing library for VitalLens. It provides a single Rust codebase that guarantees mathematical parity and high performance across all our client platforms and SDKs.

Targets

This core compiles directly into the native formats required by our clients:

1. Apple (iOS/macOS): Compiled as an .xcframework with Swift bindings via UniFFI.
2. Web (JavaScript/TypeScript): Compiled to WebAssembly (.wasm) via wasm-pack.
3. Python: Compiled as a native Python extension (.so) via PyO3 and Maturin.
4. Android: Compiled as an .aar with Kotlin bindings via UniFFI and cargo-ndk.
5. JVM (test-only): Same Kotlin bindings + a JNA-loaded native lib, for JVM unit tests.

Integration Guides

If you are looking to integrate this core into a specific environment, refer to the dedicated guides:

• 🍎 iOS / Swift Implementation Guide
• 🕸️ Web / JS Implementation Guide
• 🐍 Python Implementation Guide

Development

Prerequisites include Rust, Python 3.10+, wasm-pack, and the necessary Apple targets. See CONTRIBUTING.md for full setup instructions.

We use a universal Makefile to handle building and testing.

# Run all fast verifications and unit tests
make check

# Build release artifacts for all targets
make build

Disclaimer

The estimates provided by this software are for general wellness purposes only and are not intended for medical use. Always consult with a doctor for any health concerns or for medically precise measurements.

License

This project is licensed under the MIT License.