Skip to content

v1.0.0 - First Stable Release πŸŽ‰

Choose a tag to compare

@c2akula c2akula released this 19 Oct 17:19
· 14 commits to develop since this release

This is the first stable release of Tofu with a frozen public API.

πŸ”’ API Stability Guarantee

All public tofu_* functions are now FROZEN and follow strict semantic versioning:

  • MAJOR version: Breaking API changes only
  • MINOR version: Backward-compatible additions
  • PATCH version: Backward-compatible bug fixes

See API_STABILITY.md for full stability guarantees and deprecation policy.


✨ What's Included in v1.0.0

14 Core Operations

  • Matrix operations: matmul, add, mul
  • Activations: relu, softmax
  • Normalization: layer_norm
  • Shape ops: reshape, transpose
  • Reductions: mean, sum
  • Loss functions: MSE, cross-entropy

3 Optimizers

  • SGD (stochastic gradient descent)
  • SGD with momentum
  • Adam

Quality Assurance βœ…

  • 70+ functions with comprehensive Doxygen documentation
  • 13/13 validation tests passing
  • 100% accuracy on CNN and ResNet examples
  • Memory safe (AddressSanitizer verified, no leaks)
  • CI/CD on Linux and macOS
  • ESP32 cross-compilation support

⚠️ Known Limitations

These will be addressed in future releases:

  • Performance benchmarks not yet established (planned for v1.1.0)
  • Some broadcasting edge cases documented with TODOs
  • Limited slice functionality (start < stop only)

πŸ”„ Migration from v0.9.0

No breaking changes - v0.9.0 code works with v1.0.0 without modification.


πŸš€ What's Next

  • v1.1.0: Performance benchmarks and optimizations
  • v1.2.0+: Enhanced documentation (mdBook user guide and tutorials)

See CHANGELOG.md for detailed release notes.