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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gsam-0.2.0.tar.gz.
File metadata
- Download URL: gsam-0.2.0.tar.gz
- Upload date:
- Size: 11.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c6df5387d4bba3bd79f2d36d6127196541f09e814a5c87204f7f23f1b2f7a07
|
|
| MD5 |
4cca74a5cb9784dbee5bf4f95ea2bd83
|
|
| BLAKE2b-256 |
dd2cd61bce1c3bc2ebaede0dc188cceb5b6cf3ba3e33d508f1b038af23aca71c
|
File details
Details for the file gsam-0.2.0-py3-none-any.whl.
File metadata
- Download URL: gsam-0.2.0-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0dea5a0cd110599157a6195bd0d64f6578ddafc3525d0b429492a3bb1110f3f5
|
|
| MD5 |
a0925a04deff5dca750dfb5383bf6dfe
|
|
| BLAKE2b-256 |
1184703daacb60b7f1ea339f18a52b0db91fa76c068b249aa64feedb840893a4
|
