GSAM

GSAM (GraphScript Assembly Markup) is an orchestration language and execution engine designed around a graph-based computation model.

Installation

pip install gsam

Overview

GSAM describes how capabilities are connected together rather than how those capabilities are implemented.

A GSAM program is a graph of nodes:

nodes define reusable operations,
execution nodes define flow,
values connect operations,
Materials provide implementations.

The core engine remains minimal while external Materials provide domain-specific behavior.

Materials

Materials are external modules that extend GSAM capabilities.

A Material can provide:

application logic,
integrations,
data operations,
system operations,
reusable execution nodes.

GSAM focuses on orchestration. Materials focus on implementation.

Syntax

GSAM uses indentation to represent structure.

Core identifiers:

? Comment
$ Import Material
& Import GSAM file
! Create value
* Define node
- Execute node
+ Provide argument
= Set value or return value
: Define steering
> Define steering path

For complete syntax details, refer to the semantics example:

samples/semantics.gsam

Example

$ console

- log
  + Hello, GSAM!

Execution Model

GSAM programs are compiled into an execution graph.

Execution consists of:

Parsing source
Building intermediate representation
Constructing graph nodes
Scheduling execution
Running node implementations

GSAM does not rely on simple line-by-line execution. Nodes are processed according to their identity and execution semantics.

Architecture

Compiler Pipeline

Source parsing
Intermediate Representation (IR)
Graph construction
Execution planning

Runtime

Execution queue
Execution groups
Runtime context
Memory storage

Material System

The Material system allows GSAM to remain extensible without requiring the core engine to know every possible capability.

Design Philosophy

GSAM is built around:

Orchestration over implementation
Composition over duplication
Explicit graph structure
Small and extensible core
Separation between language and runtime behavior

Complex behavior belongs in Materials. GSAM connects those behaviors together.

Status

GSAM is under active development.

The language, runtime, and APIs may evolve as the project matures.

Metadata

Release files for gsam 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gsam 0.2.2
File	Size	Uploaded
gsam-0.2.2.tar.gz	11.5 kB	Aug 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gsam 0.2.2
File	Interpreter	ABI	Platform	Reset
gsam-0.2.2-py3-none-any.whl 15.8 kB Aug 4, 2026	Python 3	none	any	Details

Total release size: 27.3 kB

Release files / gsam-0.2.2.tar.gz

Download URL	gsam-0.2.2.tar.gz
Size	11.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`bbf18e63b0a2b90f037b310a98653bf0f070f850382509f978a2692403ff662b`
BLAKE2b-256 checksum How to use checksums	`2b3fbbe576b2a03c3928e8b683a32121bcc59801f39dcce9af2e23125f117a1e`
Upload date	Aug 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / gsam-0.2.2-py3-none-any.whl

Download URL	gsam-0.2.2-py3-none-any.whl
Size	15.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5e0c78cddd9c931d35691a9f86a5bdd52d6c0cfee51bc5fe170e706a426f7849`
BLAKE2b-256 checksum How to use checksums	`3bfbb50ba3dba38d1dda3fb10d1bb2204929e1a103a059dca3e0921ac51f4812`
Upload date	Aug 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.12.13`