npm.io
1.0.29 • Published 2h ago

@elaraai/east-py-datascience

Licence
SEE LICENSE IN LICENSE.md
Version
1.0.29
Deps
0
Size
2.1 MB
Vulns
0
Weekly
0
SummaryDependencyVersions

East Workspace

East turns a business's data and logic into decisions — and the evidence behind them. It is the computational layer of Elara: a typed, declarative model of how a business creates value and what drives it, from which the rest of the platform reads, reasons, and recommends.

The point isn't to automate judgment away. It's to put defensible evidence in front of the people who hold it — the model as a colleague, not an oracle.

Elara — a decision platform. Business users observe, decide, configure, and trust on top; underneath, the platform's surfaces (render a UI, or ask an agent) sit over a shared economic ontology (objectives, processes, resources, decisions, KPIs, policies, and data), an integrate / reason / compute engine, and East — typed TypeScript that compiles to one portable IR running unchanged on TypeScript, Python, and native C — built and evolved by engineers and coding agents with the e3 CLI, east-diagnostics, and the east Claude Code plugin.

You write it as typed TypeScript — no new language or syntax — and the same code runs across runtimes:

  • One portable IR. East compiles to a single IR that runs on TypeScript, Python, and C. Data and functions serialize across all three, so logic isn't tied to one runtime.
  • Typed platform modules. Databases, files and object storage, optimization, machine learning, Bayesian inference, simulation, and UI — typed, and composed rather than wired together with glue scripts.
  • Durable execution. e3 runs dataflow content-addressed and memoized: it reruns only what changed and keeps a replayable audit trail.
  • Works for agents and people. Indexed examples and DSL-level linting catch errors at the language level, whether the code is written by a person or an agent.

See it live at learning.elaraai.com — the East UI component showcase, doubling as the browsable index of East code examples.

Grounded in how the business actually works

Everything starts from an economic ontology — a typed graph of the business itself: its objectives, processes, resources and decisions, the KPIs that measure them and the policies that constrain them, wired together by what drives, produces, constrains, and measures what. That shared model is what lets integrations, forecasts, optimizations, and simulations reason about the same world instead of each guessing at it.

You write it once, as typed TypeScript — no new language, no new syntax. East compiles to a portable IR that runs anywhere — TypeScript, Python, or native C — so a single model spans the whole decision pipeline:

  • Integrate — pull from SQL / NoSQL databases, object storage, files, and APIs.
  • Reason — optimization, gradient boosting, neural nets, Bayesian inference, and discrete-event simulation over the ontology.
  • Execute — durable, reproducible, content-addressed dataflow that re-runs only what changed.
  • Decide — typed decision surfaces where every number carries its run, inputs, sources, assumptions, and freshness.

Declarative end to end

Every layer — integrations, models, pipelines, interfaces — is declarative, type-safe East code, which keeps a lot of the usual glue out of the picture.

The same explicitness helps agents author it: the Claude Code plugin ships East skills, indexed examples, and DSL-level linting that catches mistakes at the language level before they run. People and agents build the same way, against the same checks.

Decisions, not dashboards

A surface exists to commit one kind of decision. The platform is built around the loop an operator actually runs:

  • Observe — narrow into the situation and see the evidence, not a wall of charts.
  • Decide — commit the decision with its alternatives, reasoning, and stakes recorded, and an override always available. The model recommends; it doesn't decide for you.
  • Configure — adjust the objectives, policies, and assumptions behind the recommendation.
  • Trust — every output carries its provenance (run, inputs, sources, assumptions, freshness), and every decision lands in an audit trail you can revisit.

Numbers beat adjectives; operator-grade density over decoration.

Libraries

The pieces above, with links to the code — one row per lib, packages inside:

Library What's inside
east The language + portable IR
east-node Node.js runtime — std, io, cli
east-c Native C runtime — std, cli
east-py Python runtime — std, io, cli, data-science
e3 Durable execution engine — cli, api-server, api-client
east-ui Typed UI — east-ui, e3-ui, extension
create Project scaffolding — npm create @elaraai/east, npm create @elaraai/e3
east-claude-plugin Claude Code plugin — skills, examples, diagnostics
east-diagnostics East-aware linting — editor, agent, CI (+ eslint-plugin-east)

Each library has its own README.md with installation, a quick start, and reference.

Create a project

One command, cross-platform (Node 22+; e3 also uses Python via uv):

npm create @elaraai/e3 my-solution     # BSL-1.1 · Node + Python · durable execution
npm create @elaraai/east my-lib        # AGPL-3.0 · Node-only

Generated projects drive everything through npm scripts — npm run setup, build, test, and (e3) start / watch. Pass . to scaffold in place, or -- --install to install while scaffolding. See libs/create.

Develop

make install   # one-shot setup (pnpm + uv + cmake)
make build     # build all TypeScript packages
make test      # run all tests
make lint      # lint everything

See docs/conventions/MAKEFILE_TARGETS.md for the full target list. The monorepo ships under one unified version via the manual Release workflow (.github/workflows/release.yml) — npm, PyPI, the VS Code extension, and native C binaries in a single run.

Claude Code plugin

East ships a Claude Code plugin — language skills, search across thousands of indexed examples, and preemptive East diagnostics:

/plugin marketplace add elaraai/east-workspace
/plugin install east@elaraai

License

Multiple licenses — see the root LICENSE.md for the summary and precedence, and each lib's LICENSE.md for full terms. In short: user-facing surfaces (east, east-node, east-ui, the e3 SDK) are dual AGPL-3.0 / Commercial; runtime and server components (east-c, east-py, the e3 server stack) are BSL 1.1. Commercial licensing: support@elara.ai.

Contributing

See CONTRIBUTING.md and CLA.md. Contributors sign the CLA so we can offer commercial licenses while keeping the project open source.

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.

  • 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: 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.

  • 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.

Links

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.

Keywords

eastelaradatasciencemloptimizationmadspynomad