east-py-cli
Command-line interface for running East IR programs with Python platform functions.
Installation
uv add east-py-cli
# Platform packages are installed separately as needed
uv add east-py-std # console, crypto, fetch, fs, path, random, time
uv add east-py-io # s3, sqlite, postgres, mysql, redis, mongodb, xlsx, xml, gzip, tar, zip, ftp, sftp
uv add east-py-datascience # sklearn, scipy, xgboost, lightgbm, ngboost, torch, shap, optuna, simanneal, mads
Usage
Running Programs
# Run with platform packages
east-py run program.beast2 -p east-py-std
# Run with multiple platforms
east-py run program.json -p east-py-std -p east-py-io -p east-py-datascience
# With input and output files
east-py run program.beast2 \
-p east-py-std \
--input data.beast2 \
--input config.json \
--output result.beast2
# Verbose output
east-py run program.beast2 -p east-py-std -v
Version and Platform Info
# Show CLI version
east-py version
# Show version with platform info
east-py version -p east-py-std -p east-py-io
Example output:
east-py-cli 0.1.0
east-py 0.1.0
Platforms:
east-py-std 0.1.0 (47 platform functions)
east-py-io 0.1.0 (59 platform functions)
Transpiling and Exporting Functions
# Print an IR program (from any runtime) as python East.function source
east-py transpile program.beast2 -o program.py --name main
# Write a module's `east_functions` dict as a function manifest that a
# TypeScript e3 task imports with East.importFunction (or python with
# East.import_function); -p names the platform packages implementing any
# platform calls the functions make
east-py export-functions pricing.functions -o pricing.functions.beast2 -p east-py-std
# Only the functions an importer uses (--only, repeatable): a sibling function's
# platform call then needs no -p package
east-py export-functions pricing.functions -o pricing.functions.beast2 --only score
Linting East bodies
The build refuses python that has no East form — x // 2 on an expression,
an f-string over one, if on one, a callback reaching for np — and says
what to write instead. east-py lint says the same thing at edit time, in
the same words, over every .py file that imports east:
east-py lint src/ # one `file:line:col: category [rule] message` per finding; exit 1 on any
east-py lint src/ --format json # the findings as records
east-py lint src/ --disable no-deprecated-alias
east-py lint --list-rules # EAS001 body-takes-block-first … EAS009 no-discarded-expression
A line ending in # noqa (or # noqa: EAS002) is skipped, as under ruff.
The same rules run inside flake8 once east-py-cli is installed (flake8 --select EAS), and east-py lsp serves them to any editor over the
Language Server Protocol (pip install 'east-py-cli[lsp]' for pygls).
File Formats
IR and data files are auto-detected by extension:
| Extension | Format |
|---|---|
.beast2, .beast |
Binary East v2 |
.east |
East text format |
.json |
JSON |
Creating Platform Packages
Platform packages must export a platform attribute containing a list of platform functions:
# my_platform/__init__.py
from east import East, IntegerType, StringType
@East.platform_function(inputs=[StringType], output=IntegerType, name="my_func") # paired by name with
def my_func(s): # East.platform("my_func", …)
return len(s)
platform = East.platform_functions(__name__)
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
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-cli 1.0.77
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_cli-1.0.77.tar.gz | 52.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| elaraai_east_py_cli-1.0.77-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 89.8 kB
Release files / elaraai_east_py_cli-1.0.77.tar.gz
| Download URL | elaraai_east_py_cli-1.0.77.tar.gz |
|---|---|
| Size | 52.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cf05c69858162d502b64b757a74f306fdf948409087fc9676996bd3fc5d47d7e
|
|
BLAKE2b-256 checksum How to use checksums |
793bedb124d99010e86757267cf7c93b5604954b20749220bb8581e8d679fb0b
|
| 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_cli-1.0.77-py3-none-any.whl
| Download URL | elaraai_east_py_cli-1.0.77-py3-none-any.whl |
|---|---|
| Size | 37.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0cfa771cdd3799f337ab4fe5865f4ca60145b9408e48e31410e8fe446687f297
|
|
BLAKE2b-256 checksum How to use checksums |
ae6a93438f204ecc40fba54c9aca9c2ccd075adf8ea61ea9f7920da773617319
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
