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.
Links
- PyPI: https://pypi.org/project/gsam/
- GitLab (Main): https://gitlab.com/graphscript/gsam
- GitHub: https://github.com/graphscript-labs/gsam
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.2.tar.gz.
File metadata
- Download URL: gsam-0.2.2.tar.gz
- Upload date:
- Size: 11.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bbf18e63b0a2b90f037b310a98653bf0f070f850382509f978a2692403ff662b
|
|
| MD5 |
ab55acc518829f1995c83b9b9a7e44bf
|
|
| BLAKE2b-256 |
2b3fbbe576b2a03c3928e8b683a32121bcc59801f39dcce9af2e23125f117a1e
|
File details
Details for the file gsam-0.2.2-py3-none-any.whl.
File metadata
- Download URL: gsam-0.2.2-py3-none-any.whl
- Upload date:
- Size: 15.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e0c78cddd9c931d35691a9f86a5bdd52d6c0cfee51bc5fe170e706a426f7849
|
|
| MD5 |
f64c3ca46be9e593bc067c8cebbfbae6
|
|
| BLAKE2b-256 |
3bfbb50ba3dba38d1dda3fb10d1bb2204929e1a103a059dca3e0921ac51f4812
|
