How ml-rust/venus works
Venus is a reactive Rust notebook environment: users author .rs cells, dependencies are inferred from parameters, and cells can be run in a web UI or CLI. The server routes browser requests into notebook sessions; the core parses cells, builds dependency order, compiles and executes code, and tracks outputs. The repository also exposes IDE/LSP support, editing, widgets, markdown, rich rendering, watching, and export paths. Several core implementations are unsampled, so documented but unverified links are dashed.
Main entry points: executor.rs Cell executor · execution.rs Notebook session · main.rs Venus CLI · types.rs Dependency graph
Components 21
Notebook authoring
- Rust notebook
Notebook engine
- Cell parser
crates/venus-core/src/graph/parser.rs - Dependency graph
crates/venus-core/src/graph/types.rs - Incremental database
crates/venus-core/src/salsa_db/queries.rs - Cell compiler
crates/venus-core/src/compile/cell/compiler.rs - Cell executor
crates/venus-core/src/execute/executor.rs - Output state
crates/venus-core/src/state/manager.rs - Interactive widgets
crates/venus-core/src/widgets.rs - Rich rendering
crates/venus/src/render.rs
Interactive server
- HTTP and WS routes
crates/venus-server/src/routes.rs - Notebook session
crates/venus-server/src/session/execution.rs - Source editing
crates/venus-server/src/session/code_editing.rs - Web interface
crates/venus-server/src/frontend/app.js - IDE integration
crates/venus-server/src/lsp.rs
CLI workflows
- Venus CLI
crates/venus/cli/src/main.rs - Run and watch
crates/venus/cli/src/run.rs
Output and export
- Notebook sync parser
crates/venus-sync/src/parser.rs - Jupyter export
crates/venus-sync/src/ipynb.rs - HTML export
crates/venus/cli/src/export/html.rs
Other components
- Notebook author
- Web browser
Connections 24
- Notebook author → Rust notebook: writes cells
- Web browser → Web interface: edits notebook
- Web interface → HTTP and WS routes: sends requests
- Rust notebook → Cell parser: parses source
- Cell parser → Dependency graph: extracts dependencies
crates/venus-core/src/graph/parser.rs - Dependency graph → Incremental database: feeds queries
crates/venus-core/src/salsa_db/queries.rs - Incremental database → Cell compiler: caches compilation
crates/venus-core/src/salsa_db/queries.rs - Dependency graph → Cell executor: orders execution
- Cell compiler → Cell executor: provides compiled cells
- Cell executor → Output state: stores results
crates/venus-core/src/state/manager.rs - HTTP and WS routes → Notebook session: dispatches actions
crates/venus-server/src/routes.rs - Notebook session → Cell executor: runs cells
- Notebook session → Output state: tracks state
- Notebook session → Source editing: delegates edits
- HTTP and WS routes → IDE integration: routes IDE traffic
crates/venus-server/src/routes.rs - Venus CLI → Run and watch: dispatches run
crates/venus/cli/src/main.rs - Run and watch → Cell executor: executes notebook
- Rust notebook → Notebook sync parser: reads source
crates/venus-sync/src/parser.rs - Notebook sync parser → Jupyter export: converts cells
crates/venus-sync/src/ipynb.rs - Venus CLI → Jupyter export: exports Jupyter
- Venus CLI → HTML export: exports HTML
crates/venus/cli/src/main.rs - Cell executor → Interactive widgets: emits widget outputs
- Output state → Rich rendering: renders rich values
- Cell executor → HTML export: supplies execution output