East Data Science
Data science and ML platform functions for the East language
East Data Science provides machine learning and optimization platform functions for the East language.
Installation
npm install @elaraai/east-py-datascience @elaraai/east
Python Optional Dependencies
Each module has its own optional Python dependencies to avoid installing unnecessary packages. Install only the extras you need:
# Single extra
pip install "east-py-datascience[scipy]"
# Multiple extras
pip install "east-py-datascience[scipy,sklearn,xgboost]"
# All extras
pip install "east-py-datascience[all]"
When using a git dependency in pyproject.toml:
"east-py-datascience[scipy] @ git+https://github.com/elaraai/east-workspace@main#subdirectory=libs/east-py/packages/east-py-datascience"
| Module | Extra | Python Packages |
|---|---|---|
| MADS | mads |
PyNomadBBO |
| Optuna | optuna |
optuna |
| SimAnneal | simanneal |
simanneal |
| Scipy | scipy |
scipy, cloudpickle |
| Optimization | (none) | (core only — numpy) |
| GoogleOr | google-or |
ortools |
| Sklearn | sklearn |
scikit-learn, skl2onnx, onnxruntime, cloudpickle |
| XGBoost | xgboost |
xgboost, cloudpickle |
| LightGBM | lightgbm |
lightgbm, cloudpickle |
| NGBoost | ngboost |
ngboost, cloudpickle |
| Torch | torch |
torch, cloudpickle |
| GP | gp |
scikit-learn, cloudpickle |
| Lightning | lightning |
torch, pytorch-lightning, cloudpickle |
| Shap | shap |
shap, cloudpickle |
| MAPIE | mapie |
mapie, cloudpickle |
| ALNS | alns |
alns |
| PyMC | pymc |
pymc, cloudpickle |
| Simulation | (none) | (core only — numpy) |
| Causal | causal |
dowhy, econml, PyALE, pandas, matplotlib, scikit-learn, cloudpickle |
Quick Start
import { East, FloatType, variant } from "@elaraai/east";
import { MADS } from "@elaraai/east-py-datascience";
// Define objective function: minimize sum of squares
const objective = East.function([MADS.Types.VectorType], FloatType, ($, x) => {
const x0 = $.let(x.get(0n));
const x1 = $.let(x.get(1n));
return $.return(x0.multiply(x0).add(x1.multiply(x1)));
});
// Optimize
const optimize = East.function([], MADS.Types.ResultType, $ => {
const x0 = $.let([0.5, 0.5]);
const bounds = $.let({
lower: [-1.0, -1.0],
upper: [1.0, 1.0],
});
const config = $.let({
max_bb_eval: variant('some', 100n),
display_degree: variant('some', 0n),
direction_type: variant('none', null),
initial_mesh_size: variant('none', null),
min_mesh_size: variant('none', null),
seed: variant('some', 42n),
});
return $.return(MADS.optimize(objective, x0, bounds, variant('none', null), config));
});
Modules
Optimization
| Module | Description | Use Cases |
|---|---|---|
| MADS | Derivative-free blackbox optimization using NOMAD algorithm | Functions without derivatives, expensive evaluations, noisy/discontinuous objectives |
| Optuna | Bayesian optimization with TPE sampler | Hyperparameter tuning, mixed-type parameters, efficient search with few evaluations |
| SimAnneal | Simulated annealing for discrete optimization | TSP, scheduling, subset selection, knapsack, assignment problems |
| Scipy | Scientific optimization and curve fitting | Gradient-based minimization, curve fitting, interpolation, statistics |
| Optimization | Iterative coordinate descent optimization | Parameter tuning, sequential optimization across parameter groups |
| GoogleOr | Google OR-Tools constraint programming, routing, LP, and graph algorithms | CP-SAT, vehicle routing (TSP/VRP), linear/mixed-integer programming, min-cost flow, max flow, assignment, sparse min-cost assignment |
Machine Learning
| Module | Description | Use Cases |
|---|---|---|
| Sklearn | Core ML utilities from scikit-learn | N-way splits, preprocessing (Standard/MinMax/RobustScaler), encoding (Label/Ordinal), metrics, GMM clustering, multi-target regression |
| XGBoost | Gradient boosting with XGBoost | Regression, classification, feature importance, fast training |
| LightGBM | Fast gradient boosting with leaf-wise growth | Large datasets, high cardinality features, faster than XGBoost on big data |
| NGBoost | Natural gradient boosting with uncertainty | Probabilistic predictions, confidence intervals, uncertainty quantification |
| Torch | Neural networks with PyTorch | MLP regression/classification, deep learning, custom architectures |
| Lightning | PyTorch Lightning neural networks | MLP, autoencoder, conv1d, sequential, transformer architectures |
| GP | Gaussian Process regression | Small datasets, uncertainty quantification, Bayesian optimization surrogate |
| MAPIE | Conformal prediction intervals | Prediction intervals, prediction sets, uncertainty quantification |
Bayesian Inference
| Module | Description | Use Cases |
|---|---|---|
| PyMC | Bayesian inference with PyMC | Bayesian linear regression, hierarchical models, multi-layer joint estimation, posterior analysis |
Causal Inference
| Module | Description | Use Cases |
|---|---|---|
| Causal | One declarative causal experiment (Causal.experiment) over DoWhy / EconML / PyALE internals, plus Causal.designValidation (statsmodels power) |
Naive vs adjusted effect, confounder balance, propensity overlap, placebo/E-value robustness, and an honesty verdict (refuses when the data can't support an answer); and the real controlled-trial recipe that would confirm it — sample size, split, match-on categories, and a power curve |
Simulation
| Module | Description | Use Cases |
|---|---|---|
| Simulation | Economic ontology simulation via DES | Simulating economic resources, events, and processes; single deterministic runs, Monte Carlo trajectories |
Explainability
| Module | Description | Use Cases |
|---|---|---|
| Shap | SHAP values for model interpretation | Feature importance, model explanations, debugging predictions |
Documentation
See USAGE.md for detailed API reference with examples.
Development
npm run build # Compile TypeScript
npm run test # Run test suite
npm run lint # Check code quality
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@elaraai
License
This package has different licenses for TypeScript and Python code:
TypeScript (type definitions): Dual AGPL-3.0 / Commercial
- Open source use: AGPL-3.0
- Commercial use: Available for proprietary use - contact support@elara.ai
Python (runtime implementations): BSL 1.1 (Business Source License)
- Non-production use (evaluation, testing, development) is free
- Production use by or on behalf of for-profit entities requires a commercial license
- Code becomes AGPL-3.0 four years after each release
See LICENSE.md for full details.
Commercial licensing: support@elara.ai
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: support@elara.ai
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
1 maintainer
Metadata
1 maintainer
Release files for elaraai-east-py-datascience 1.0.71
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| elaraai_east_py_datascience-1.0.71.tar.gz | 748.1 kB | Details |
Built distributions (wheels)
Total release size: 4.4 MB
Release files / elaraai_east_py_datascience-1.0.71.tar.gz
| Download URL | elaraai_east_py_datascience-1.0.71.tar.gz |
|---|---|
| Size | 748.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4adbb586bfbdbbd4fb01407db2bd28efbcd01cba110cef770a073b5d45c4a346
|
|
BLAKE2b-256 checksum How to use checksums |
5d21b113c3f0e9465ffafd081cac55324db7b430512e32cb73a82b1934f12a23
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp313-cp313-win_amd64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 245.3 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3aa9964be6aa7361abd7db206981cde140a2f9574bb3f35364033f3283f61ba5
|
|
BLAKE2b-256 checksum How to use checksums |
1acd214766314631746420d2bbfce4d5aaaf5c4f04d7457c9d48673ae13428ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp313-cp313-win32.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp313-cp313-win32.whl |
|---|---|
| Size | 242.3 kB |
| Tags | CPython 3.13 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
4b3e6e195e7a0683474d00c171f553db5dde5dd7723d737a187e33727dbbcfc3
|
|
BLAKE2b-256 checksum How to use checksums |
c1cd0c7bf75bf6d4cbabcf1b18e28fc722c515cd244eae4d2d36d386d83aa4a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 242.8 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
697fd591925817de8cf7d5dbd80e9383ffb7dff3a019ae60ba8ef0d76e933f70
|
|
BLAKE2b-256 checksum How to use checksums |
1063443699ba06854a82110e00d2618ba8cabae5523f3b5768d6efc89979156c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 240.8 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5ff1010f18c9737c9976f0a30545eee4661e1dceedf8146479beb8bf1b6d6cda
|
|
BLAKE2b-256 checksum How to use checksums |
be692098311ad856fe7b76cbecdf91f8ca923d962e0e92f36b0d8f439ffd1785
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp313-cp313-macosx_10_13_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp313-cp313-macosx_10_13_x86_64.whl |
|---|---|
| Size | 241.5 kB |
| Tags | CPython 3.13 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
870f7876f1e81551c43d414769634aea69a9f9df95bdf8d7b29223c700d7dec5
|
|
BLAKE2b-256 checksum How to use checksums |
d6013ea425a02744e2b5e8efecc960e69fb3e7f9bea422c55294ef2be79657b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp312-cp312-win_amd64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 245.3 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5445991b97961a8cc5e3fd4b2c4c1d3e54d984cfcf0b24f2da77a434101cdf52
|
|
BLAKE2b-256 checksum How to use checksums |
043e224f7476ecf98bbd78ad0d2e19116a7ccea2ff15a1066ed8619e6fab8e9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp312-cp312-win32.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp312-cp312-win32.whl |
|---|---|
| Size | 242.4 kB |
| Tags | CPython 3.12 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
d19783a23534aea9d5ec1ac37e5a4acd7afdc075499cdcc2e8030e8b27d652fa
|
|
BLAKE2b-256 checksum How to use checksums |
8f834899c97e7a080e4b6b222fcecc15b8fe4cbeb8502c877e36cb602fa3f544
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 242.8 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
f59ba8a99f3ff9c6d31320fb270bd262bbc4f343597dd8262ad3179757c1f3ec
|
|
BLAKE2b-256 checksum How to use checksums |
7585d91cfd1324701148e92cb4ee2ed6a773086e2505142c64b5fe3c7b35e0c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 240.8 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b6e91cba4192104e26ec868bbefc83080c278d5353d9e828712b6be4b3c6ef85
|
|
BLAKE2b-256 checksum How to use checksums |
de6ce6526373d88f92a26005ac488b3b858901e02dad1755d35b1510c569b08c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 241.5 kB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
fe1a74ce1f935d4f8c9ed23c6ee777efa1cc78e3e05e45a45072a5358e993690
|
|
BLAKE2b-256 checksum How to use checksums |
bf218224016ae5dfce56eff8950d5883ecaf992d2d07658e11f8a9e41b45cbec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp311-cp311-win_amd64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 245.1 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
91375d9cf7b74cd66178c2541045f9f2e194b3dd102f93c3c08856803dc29138
|
|
BLAKE2b-256 checksum How to use checksums |
778679b90ffb319137cd0ae014327b0c5980f5a749c66c953596a11322232221
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp311-cp311-win32.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp311-cp311-win32.whl |
|---|---|
| Size | 242.3 kB |
| Tags | CPython 3.11 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
be06dee366d4810b012a62013659f9c1b7d9b5c16d3e95040b0f6d1b78d390c7
|
|
BLAKE2b-256 checksum How to use checksums |
b59c39a7d496c13e66faea041316531ddfb55529199f68b2eef7d2e45ac620ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 242.7 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
a3cea162106ab3b0c0c165e1db06c35ac1fc4408a7925f34affa1c91f54b158a
|
|
BLAKE2b-256 checksum How to use checksums |
882b99ced4011e101d7d7ef87bcd91417a1cdad37f06435ac560ebb353dc3435
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 240.6 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
89780ae4e0024315448291752f43570644c78cada22515cd28ec3e6f38ce6c50
|
|
BLAKE2b-256 checksum How to use checksums |
ac0e6f6486152050d12a40da0ac504755736330f1ae0ed4a06f37308cee2b555
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / elaraai_east_py_datascience-1.0.71-cp311-cp311-macosx_10_9_x86_64.whl
| Download URL | elaraai_east_py_datascience-1.0.71-cp311-cp311-macosx_10_9_x86_64.whl |
|---|---|
| Size | 241.3 kB |
| Tags | CPython 3.11 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
9e6953fe2e640ee6b877ddb7dd3bef7ba83cc3b99a4d89d180bf8058ec4271b4
|
|
BLAKE2b-256 checksum How to use checksums |
dcb65646045d79f366f965beabd28076a984ae39caa15b1bd34ebedd80b07dd2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
