How raven-ml/raven works
Raven is an OCaml scientific-computing ecosystem. Its documented user-facing capabilities include arrays and ML compilation, tokenization, notebook-based interaction, and experiment tracking. The excerpts show internal detail chiefly for Nx’s CPU engine and codecs, Tolk’s CUDA runtime, and Quill’s notebook frontend; other package relationships are therefore kept separate rather than inferred. Several README-described capabilities have only partial source coverage in this tree.
Main entry points: app.js Notebook interface · cpu N-dimensional arrays · cell.js Cell rendering · notebook.js Notebook renderer
Components 23
Arrays and numerics
- N-dimensional arrays
packages/nx/lib/cpu - CPU execution engine
packages/nx/lib/cpu/nx_c_engine.c - CPU kernel families
packages/nx/lib/cpu - Low-precision types
packages/nx/lib/dtype/nx_dtype.h - Device backends
packages/nx/lib/device - Image and data codecs
packages/nx/lib/io/codec
ML computation
- ML compiler
packages/tolk/lib - CPU runtime
packages/tolk/lib/runtime/cpu/tolk_cpu_stubs.c - CUDA runtime
packages/tolk/lib/runtime/cuda/tolk_cuda_stubs.c - Dynamic library loader
packages/tolk/lib/runtime/support/tolk_dl.h - Other device runtimes
packages/tolk/lib/runtime
Interactive notebooks
- Notebook interface
packages/quill/lib/quill-server/frontend/src/app.js - Notebook state
packages/quill/lib/quill-server/frontend/src/store.js - WebSocket client
packages/quill/lib/quill-server/frontend/src/ws.js - Notebook renderer
packages/quill/lib/quill-server/frontend/src/notebook.js - Cell rendering
packages/quill/lib/quill-server/frontend/src/cell.js - Code editor
packages/quill/lib/quill-server/frontend/src/editor.js - Output rendering
packages/quill/lib/quill-server/frontend/src/output.js - Math rendering
packages/quill/lib/quill-server/frontend/src/math.js - Keyboard shortcuts
packages/quill/lib/quill-server/frontend/src/shortcuts.js
Data and tracking
- Tokenizer
packages/brot/lib/brot_kernels.c - Experiment tracking
packages/munin/lib/sys/sysstat_stubs.c
Other components
- OCaml user
Connections 19
- OCaml user → N-dimensional arrays: uses arrays
- OCaml user → ML compiler: uses compiler
- OCaml user → Notebook interface: opens notebooks
- OCaml user → Tokenizer: tokenizes text
- OCaml user → Experiment tracking: tracks experiments
- N-dimensional arrays → CPU execution engine: runs CPU operations
packages/nx/lib/cpu/nx_c_engine.c - CPU execution engine → CPU kernel families: dispatches kernels
packages/nx/lib/cpu/nx_c_engine.h - N-dimensional arrays → Low-precision types: uses types
packages/nx/lib/cpu/nx_c.h - N-dimensional arrays → Device backends: uses devices
packages/nx/lib/cpu/nx_c.h - Notebook interface → Notebook state: creates state
packages/quill/lib/quill-server/frontend/src/app.js - Notebook interface → WebSocket client: creates client
packages/quill/lib/quill-server/frontend/src/app.js - Notebook interface → Notebook renderer: mounts renderer
packages/quill/lib/quill-server/frontend/src/app.js - Notebook interface → Keyboard shortcuts: initializes shortcuts
packages/quill/lib/quill-server/frontend/src/app.js - Notebook renderer → Cell rendering: renders cells
packages/quill/lib/quill-server/frontend/src/notebook.js - Notebook renderer → Output rendering: appends output
packages/quill/lib/quill-server/frontend/src/notebook.js - Cell rendering → Code editor: creates editors
packages/quill/lib/quill-server/frontend/src/cell.js - Cell rendering → Math rendering: renders math
packages/quill/lib/quill-server/frontend/src/cell.js - Cell rendering → Output rendering: renders outputs
packages/quill/lib/quill-server/frontend/src/cell.js - CUDA runtime → Dynamic library loader: resolves symbols
packages/tolk/lib/runtime/cuda/tolk_cuda_stubs.c