@elaraai/east-node-cli
v1.0.39
Published
Command-line interface for running East IR programs with Node.js
Maintainers
Readme
East Node CLI
Command-line interface for running East IR programs with Node.js
East Node CLI provides a command-line interface for executing compiled East IR programs using Node.js platform implementations.
Installation
# Install the CLI
npm install -g @elaraai/east-node-cli
# Install platform packages (required)
npm install @elaraai/east-node-std
npm install @elaraai/east-node-io # if using I/O functionsUsage
Running Programs
# Run with standard platform
east-node run ./program.beast2 -p @elaraai/east-node-std
# Run with multiple platforms
east-node run ./db-query.beast2 \
-p @elaraai/east-node-std \
-p @elaraai/east-node-io
# Run with input files
east-node run ./transform.beast2 \
-p @elaraai/east-node-std \
-i input.json \
-i config.east
# Run with output file
east-node run ./process.beast2 \
-p @elaraai/east-node-std \
-i input.beast2 \
-o result.json
# Verbose mode
east-node run ./program.beast2 -p @elaraai/east-node-std -vVersion Information
# Show CLI version
east-node version
# Show CLI and platform versions
east-node version -p @elaraai/east-node-std -p @elaraai/east-node-ioCLI Reference
east-node run
Execute an East IR program.
east-node run <ir_file> [options]
Arguments:
ir_file Path to IR file (.beast2, .beast, .east, or .json)
Options:
-p, --package <package> Platform package to load (can be repeated)
-i, --input <file> Input data file (can be repeated)
-o, --output <file> Output file path for result
-v, --verbose Enable verbose output
-h, --help Display helpeast-node version
Show version information.
east-node version [options]
Options:
-p, --package <package> Platform package to check (can be repeated)Supported File Formats
| Extension | Format |
|-----------|--------|
| .beast2, .beast | Binary East format |
| .east | Text East format |
| .json | JSON format |
Platform Packages
Platform packages provide the runtime implementations for East platform functions:
- @elaraai/east-node-std - Standard platform (console, filesystem, crypto, time, etc.)
- @elaraai/east-node-io - I/O platform (SQL, S3, FTP, Redis, MongoDB, etc.)
Creating Platform Packages
Any npm package can provide platform functions by following this convention:
- Export a
./platformsubpath that default-exportsPlatformFunction[] - Export
./package.jsonfor version discovery
See the design document for details.
Claude Code plugin
The East ecosystem also ships a Claude Code plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the elaraai marketplace:
# Inside Claude Code
/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai# From a terminal
claude plugin marketplace add elaraai/east-workspace
claude plugin install east@elaraaiLicense
Dual-licensed:
- Open Source: AGPL-3.0 - Free for open source use
- Commercial: Available for proprietary use - contact [email protected]
Ecosystem
East: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.
- @elaraai/east: Core language SDK with type system, expressions, and reference JS compiler
East Node: Node.js platform functions for I/O, databases, and system operations.
- @elaraai/east-node-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
- @elaraai/east-node-io: SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
- @elaraai/east-node-cli: CLI for running East IR programs in Node.js
East C: C11 native runtime for executing East IR. Distributed via npm (launcher + per-platform optional dependencies) and as tarballs on each GitHub Release.
- @elaraai/east-c-cli: npm launcher — installs the matching native binary as an optional dependency
east-c: Core runtime — type system, IR interpreter, builtins, serialization (Beast2, JSON, CSV, East text)east-c-std: Console, FileSystem, Fetch, Crypto, Time, Path, Randomeast-c-cli: CLI for running East IR programs natively
East Python: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.
- east-py: Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
- east-py-std: Console, FileSystem, Fetch, Crypto, Time, Path, Random
- east-py-io: SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
- east-py-cli: CLI for running East IR programs in Python
- east-py-datascience (PyPI) + @elaraai/east-py-datascience (npm): Optimization (MADS, Optuna, ALNS, GoogleOR), ML (XGBoost, LightGBM, NGBoost, PyTorch, Lightning, GP), Bayesian inference (PyMC), explainability (SHAP), conformal prediction (MAPIE)
East UI: Typed UI component definitions and React renderer, plus VS Code preview.
- @elaraai/east-ui: 50+ typed UI components for layouts, forms, charts, tables, dialogs
- @elaraai/east-ui-components: React renderer with Chakra UI v3 styling
- @elaraai/e3-ui: e3 + UI bridge — Data bindings,
e3.ui()task, manifest - @elaraai/e3-ui-components: React Query hooks and preview components for the e3 API
- east-ui-preview: VS Code extension for live East UI component preview
e3 — East Execution Engine: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.
- @elaraai/e3: SDK for authoring e3 packages with typed tasks and pipelines
- @elaraai/e3-core: Object store, dataflow orchestrator, execution state
- @elaraai/e3-types: Shared type definitions for e3 packages
- @elaraai/e3-cli:
e3 repo,e3 package,e3 workspace,e3 start,e3 watch,e3 logscommands - @elaraai/e3-api-client: HTTP client for remote e3 repositories
- @elaraai/e3-api-server: REST API server for e3 repositories
- @elaraai/e3-api-tests: Shared API compliance test suites
Links
- Website: https://elaraai.com/
- East Repository: https://github.com/elaraai/east-workspace/tree/main/libs/east
- Issues: https://github.com/elaraai/east-workspace/issues
- Email: [email protected]
About Elara
East is developed by Elara AI Pty Ltd, an AI-powered platform that creates economic digital twins of businesses that optimize performance. Elara combines business objectives, decisions and data to help organizations make data-driven decisions across operations, purchasing, sales and customer engagement, and project and investment planning. East powers the computational layer of Elara solutions, enabling the expression of complex business logic and data in a simple, type-safe and portable language.
Developed by Elara AI Pty Ltd.
Developed by Elara AI Pty Ltd
