@elaraai/east-py-datascience 0.0.2-beta.9 → 1.0.0

package/CLA.md

@@ -0,0 +1,26 @@
+# Contributor License Agreement
+
+This Contributor License Agreement ("Agreement") is entered into between Elara AI Pty Ltd ("Company") and you (the "Contributor").
+
+## Grant of Copyright License
+
+You hereby grant to the Company and to recipients of software distributed by the Company a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, distribute, and use Your Contributions and such derivative works.
+
+## Grant of Patent License
+
+You hereby grant to the Company and to recipients of software distributed by the Company a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer Your Contributions.
+
+## Relicensing Rights
+
+You grant the Company the right to license Your Contributions under any license terms, including but not limited to commercial licenses, in addition to the open source license under which the project is distributed.
+
+## Your Representations
+
+You represent that:
+- You are legally entitled to grant the above licenses
+- Each of Your Contributions is Your original creation
+- Your Contribution submissions include complete details of any third-party license or other restriction of which you are aware
+
+## Agreement
+
+By signing this Agreement through CLA Assistant or by submitting a Contribution, you accept and agree to the terms of this Agreement.

package/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing to east-py-datascience
+
+Thank you for your interest in contributing! We welcome contributions from the community.
+
+## Contributor License Agreement (CLA)
+
+Before we can accept your contribution, you must sign our Contributor License Agreement (CLA). This agreement gives Elara AI Pty Ltd the right to use and relicense your contributions, including under commercial licenses, while you retain ownership of your contribution.
+
+**Why do we require a CLA?**
+This project is dual-licensed under AGPL-3.0 and commercial licenses. The CLA allows us to offer commercial licenses to users who wish to use this software in proprietary applications.
+
+### Signing the CLA
+
+When you submit your first pull request, the CLA Assistant bot will automatically comment on your PR with a link to sign the CLA electronically. It only takes a minute, and you'll only need to sign it once.
+
+## Contributing Process
+
+1. Fork the [east-workspace monorepo](https://github.com/elaraai/east-workspace)
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Commit your changes (`git commit -m 'Add amazing feature'`)
+5. Push to the branch (`git push origin feature/amazing-feature`)
+6. Open a Pull Request
+7. Sign the CLA when the bot prompts you
+
+## Questions?
+
+Contact us at support@elara.ai

package/LICENSE.md

@@ -1,7 +1,7 @@
-# Licensing
-
 Copyright (c) 2025 Elara AI Pty Ltd
 
+# Dual License — AGPL-3.0 (TypeScript) / BSL 1.1 (Python)
+
 This package contains both TypeScript and Python code with different licenses:
 
 ## TypeScript (npm package: @elaraai/east-py-datascience)

package/README.md

@@ -6,7 +6,7 @@
 [![Python: BSL 1.1](https://img.shields.io/badge/Python-BSL%201.1-orange.svg)](LICENSE.md)
 [![Node Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org)
 
-**East Data Science** provides machine learning and optimization platform functions for the [East language](https://github.com/elaraai/East).
+**East Data Science** provides machine learning and optimization platform functions for the [East language](https://github.com/elaraai/east-workspace/tree/main/libs/east).
 
 ## Installation
 
@@ -14,6 +14,47 @@
 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:
+
+```bash
+# 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`:
+```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)* |
+
 ## Quick Start
 
 ```typescript
@@ -57,17 +98,33 @@ const optimize = East.function([], MADS.Types.ResultType, $ => {
 | **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 |
 
 ### Machine Learning
 
 | Module | Description | Use Cases |
 |--------|-------------|-----------|
-| **Sklearn** | Core ML utilities from scikit-learn | Train/test split, preprocessing (StandardScaler, MinMaxScaler), metrics, multi-target regression |
+| **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 |
+
+### Simulation
+
+| Module | Description | Use Cases |
+|--------|-------------|-----------|
+| **Simulation** | Economic ontology simulation via DES | Simulating economic resources, events, and processes; single deterministic runs, Monte Carlo trajectories |
 
 ### Explainability
 
@@ -87,6 +144,22 @@ npm run test      # Run test suite
 npm run lint      # Check code quality
 ```
 
+## Claude Code plugin
+
+The East ecosystem also ships a [Claude Code](https://claude.com/claude-code) plugin — East language skills, example search, and preemptive diagnostics for East code — installed separately from the `elaraai` marketplace:
+
+```text
+# Inside Claude Code
+/plugin marketplace add elaraai/east-workspace
+/plugin install east@elaraai
+```
+
+```bash
+# 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:
@@ -106,31 +179,47 @@ See [LICENSE.md](LICENSE.md) for full details.
 
 ### Ecosystem
 
-- **[East Node](https://github.com/elaraai/east-node)**: Node.js platform functions for I/O, databases, and system operations. Connect East programs to filesystems, SQL/NoSQL databases, cloud storage, and network services.
-  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Filesystem, console, HTTP fetch, crypto, random distributions, timestamps
-  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, S3, FTP, SFTP
+- **[East](https://github.com/elaraai/east-workspace/tree/main/libs/east)**: Statically typed, expression-based language with serializable IR. Run portable logic across TypeScript, Python, C, and other runtimes.
+  - [@elaraai/east](https://www.npmjs.com/package/@elaraai/east): Core language SDK with type system, expressions, and reference JS compiler
+
+- **[East Node](https://github.com/elaraai/east-workspace/tree/main/libs/east-node)**: Node.js platform functions for I/O, databases, and system operations.
+  - [@elaraai/east-node-std](https://www.npmjs.com/package/@elaraai/east-node-std): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
   - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
 
-- **[East Python](https://github.com/elaraai/east-py)**: Python runtime and platform functions for data science and machine learning. Execute East programs with access to optimization solvers, gradient boosting, neural networks, and model explainability.
-  - [@elaraai/east-py-datascience](https://www.npmjs.com/package/@elaraai/east-py-datascience): TypeScript types for optimization, gradient boosting, neural networks, explainability
+- **[East C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11 native runtime for executing East IR. Tarballed for `linux-x64` and `linux-arm64`, attached to each GitHub Release.
+  - `east-c`: Core runtime — type system, IR interpreter, 200+ builtins, serialization (Beast2, JSON, CSV, East text)
+  - `east-c-std`: Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - `east-c-cli`: CLI for running East IR programs natively
+
+- **[East Python](https://github.com/elaraai/east-workspace/tree/main/libs/east-py)**: Python runtime, standard platform, I/O, and data-science platform functions. Published to PyPI.
+  - [east-py](https://pypi.org/project/east-py/): Core Python runtime — type system, IR compiler, 212+ builtins, Cython-accelerated hot paths
+  - [east-py-std](https://pypi.org/project/east-py-std/): Console, FileSystem, Fetch, Crypto, Time, Path, Random
+  - [east-py-io](https://pypi.org/project/east-py-io/): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
+  - [east-py-cli](https://pypi.org/project/east-py-cli/): CLI for running East IR programs in Python
+  - [east-py-datascience](https://pypi.org/project/east-py-datascience/) (PyPI) + [@elaraai/east-py-datascience](https://www.npmjs.com/package/@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](https://github.com/elaraai/east-ui)**: East types and expressions for building dashboards and interactive layouts. Define UIs as data structures that render consistently across React, web, and other environments.
+- **[East UI](https://github.com/elaraai/east-workspace/tree/main/libs/east-ui)**: Typed UI component definitions and React renderer, plus VS Code preview.
   - [@elaraai/east-ui](https://www.npmjs.com/package/@elaraai/east-ui): 50+ typed UI components for layouts, forms, charts, tables, dialogs
-  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI styling
+  - [@elaraai/east-ui-components](https://www.npmjs.com/package/@elaraai/east-ui-components): React renderer with Chakra UI v3 styling
+  - [@elaraai/e3-ui](https://www.npmjs.com/package/@elaraai/e3-ui): e3 + UI bridge — Data bindings, `e3.ui()` task, manifest
+  - [@elaraai/e3-ui-components](https://www.npmjs.com/package/@elaraai/e3-ui-components): React Query hooks and preview components for the e3 API
+  - [east-ui-preview](https://marketplace.visualstudio.com/items?itemName=ElaraAI.east-ui-preview): VS Code extension for live East UI component preview
 
-- **[e3 - East Execution Engine](https://github.com/elaraai/e3)**: Durable execution engine for running East pipelines at scale. Features Git-like content-addressable storage, automatic memoization, task queuing, and real-time monitoring.
+- **[e3 — East Execution Engine](https://github.com/elaraai/east-workspace/tree/main/libs/e3)**: Durable execution engine for running East pipelines at scale. Git-like content-addressable storage, automatic memoization, reactive dataflow, real-time monitoring.
   - [@elaraai/e3](https://www.npmjs.com/package/@elaraai/e3): SDK for authoring e3 packages with typed tasks and pipelines
-  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Git-like object store, task queue, result caching
+  - [@elaraai/e3-core](https://www.npmjs.com/package/@elaraai/e3-core): Object store, dataflow orchestrator, execution state
   - [@elaraai/e3-types](https://www.npmjs.com/package/@elaraai/e3-types): Shared type definitions for e3 packages
-  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 init`, `e3 run`, `e3 logs` commands for managing and monitoring tasks
-  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 servers
+  - [@elaraai/e3-cli](https://www.npmjs.com/package/@elaraai/e3-cli): `e3 repo`, `e3 package`, `e3 workspace`, `e3 start`, `e3 watch`, `e3 logs` commands
+  - [@elaraai/e3-api-client](https://www.npmjs.com/package/@elaraai/e3-api-client): HTTP client for remote e3 repositories
   - [@elaraai/e3-api-server](https://www.npmjs.com/package/@elaraai/e3-api-server): REST API server for e3 repositories
+  - [@elaraai/e3-api-tests](https://www.npmjs.com/package/@elaraai/e3-api-tests): Shared API compliance test suites
 
 ## Links
 
 - **Website**: [https://elaraai.com/](https://elaraai.com/)
-- **East Repository**: [https://github.com/elaraai/East](https://github.com/elaraai/East)
-- **Issues**: [https://github.com/elaraai/east-py/issues](https://github.com/elaraai/east-py/issues)
+- **East Repository**: [https://github.com/elaraai/east-workspace/tree/main/libs/east](https://github.com/elaraai/east-workspace/tree/main/libs/east)
+- **Issues**: [https://github.com/elaraai/east-workspace/issues](https://github.com/elaraai/east-workspace/issues)
 - **Email**: support@elara.ai
 
 ## About Elara
@@ -139,4 +228,8 @@ East is developed by [Elara AI Pty Ltd](https://elaraai.com/), an AI-powered pla
 
 ---
 
+*Developed by [Elara AI Pty Ltd](https://elaraai.com/).*
+
+---
+
 *Developed by [Elara AI Pty Ltd](https://elaraai.com/)*