gsam 0.1.0

Compiler toolchain for the GSAM language.

GSAM

GSAM compiler and execution engine

Installation

pip install gsam

About

GSAM is a compiler and execution engine built around a graph-based computation model. It is designed for extensibility, where external “Materials” define behavior and execution logic in a modular way.

Instead of traditional linear execution, GSAM represents programs as graphs of nodes, enabling flexible control flow, parallel execution patterns, and pluggable runtime behavior.

Syntax Overview

Refer to the Semantics Example for detailed syntax descriptions and usage.

? comment block (multi-line via indentation)
  lines starting with indentation are treated as part of the comment

- parent node
  = variable assignment
  @ keyword_argument
    + value
  + positional_argument
  > next node option

Example

Hello World

? use console material
$ console

? "log" node comes from "console"
- log
  + "Hello, GSAM!"

Architecture

GSAM is built as a graph-native execution system with layered components:

Pipeline

Source code flows through:

• Parsing
• Intermediate Representation (IR)
• Graph construction
• Execution

Execution Engine

• Execution Queue (node scheduling)
• Execution Clusters (parallel groups)
• Execution Stack (scoped runtime context)
• Memory Bank (runtime state storage)

Materials System

• External modules defining execution behavior
• Plug-in style extensibility
• Core engine remains minimal and generic

Core Artifacts

• Data nodes (computation units)
• Execution units (runtime tasks)
• Memory structures (state persistence)

Design Philosophy

GSAM follows a minimal and explicit design approach:

• Graph-native execution model
• Extensible through external modules called “Materials”
• Minimal assumptions in the core engine
• Clear separation between syntax, execution, and behavior

Status

GSAM is under active development.
The architecture and APIs may evolve as the system matures.

Links

• PyPI: https://pypi.org/project/gsam/
• GitHub: https://github.com/graphscript-labs/gsam
• License: https://github.com/graphscript-labs/gsam/tree/main/LICENSE

---

Made with <3 by AttAditya