east-py

Compile and execute East IR via a Cython bridge to the east-c runtime.

Updated Nov 10, 2025
One-click install
npx skills add https://github.com/elaraai/east-workspace --skill east-py
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: east-py
Source: https://github.com/elaraai/east-workspace/tree/main/libs/east-py/packages/east-py
Command: npx skills add https://github.com/elaraai/east-workspace --skill east-py

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sortedcontainers, typing-extensions, numpy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the performance and correctness issues associated with bridging the East programming language with Python, preventing the common anti-pattern of round-tripping data through inefficient pure-Python collections.

Core Features & Use Cases

  • Native Execution: Enables East IR to run natively via a Cython bridge to the east-c runtime, ensuring high-speed execution of complex business logic.
  • Eager Value Methods: Provides chained, eager methods for collections (map, filter, fold, group_by) that execute entirely in C, avoiding costly Python interpreter loops.
  • Platform Integration: Allows seamless exposure of Python functions to East with output validation, supporting both synchronous and asynchronous operations.

Quick Start

Use the east-py skill to compile and execute the provided East IR JSON file using the defined platform functions.

Frequently Asked Questions about east-py

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute East IR logic natively within a Python environment?

You can execute East IR natively in Python by using a Cython bridge to the east-c runtime, which compiles business logic across typed data structures while maintaining deterministic behavior and total order.

Can I expose Python functions to East pipelines with type validation?

Yes, you can expose Python functions to East pipelines with strict output validation, supporting both synchronous and asynchronous operations to integrate platform functions directly into the dataflow.

How do East eager value methods improve Python collection performance?

Eager value methods like map, filter, fold, and group_by execute entirely in C, avoiding costly Python interpreter loops and preventing performance issues caused by round-tripping data through inefficient pure-Python collections.

Do I need Cython and numpy to run East logic in Python?

Yes, the runtime relies on a Cython bridge to the native east-c runtime and requires dependencies including numpy, sortedcontainers, and typing-extensions to facilitate typed data structure transformation and strict type validation.

What are the limitations of running East business logic in Python?

The primary constraint involves avoiding anti-patterns like round-tripping data through inefficient pure-Python collections; instead, operations must leverage the native C execution bridge to maintain high performance and deterministic total order.