diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000000000000000000000000000000000000..ed72ca48102eb4eb1271aba2540f6f05aa66193e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,42 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+### Changed
+
+### Removed
+
+### Fixed
+
+
+## [24.6.2] - 2024-11-26
+
+### Added
+
+- example of RIXS plane extraction
+- `famewoks.utils`
+- `famewoks.controller`: initial version
+
+### Changed
+
+- `get_y` moved in `famewoks.utils`
+
+### Fixed
+
+- fixed [#13](https://gitlab.esrf.fr/F-CRG/fames/famewoks/-/issues/13)
+
+
+## [24.5.3] - 2024-07-01
+
+- new data model
+
+## [24.4.0] - 2024-05-03
+
+- first stable release
\ No newline at end of file