{"id":42126244,"url":"https://github.com/hyperifyio/gnd","last_synced_at":"2026-01-26T15:09:00.875Z","repository":{"id":291919298,"uuid":"977885615","full_name":"hyperifyio/gnd","owner":"hyperifyio","description":"Gendo Lang","archived":false,"fork":false,"pushed_at":"2025-06-01T11:05:59.000Z","size":4558,"stargazers_count":0,"open_issues_count":97,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-01T20:11:57.734Z","etag":null,"topics":["ai","bitnet-llm","deterministic","functional-programming","llm","openai","openai-api","pipeline","programming-language","prompt-engineering"],"latest_commit_sha":null,"homepage":"https://hyperifyio.github.io/gnd/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperifyio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-05T06:05:07.000Z","updated_at":"2025-05-19T08:56:17.000Z","dependencies_parsed_at":"2025-05-07T08:22:38.988Z","dependency_job_id":"7a51f90b-fce3-4fe6-ba08-b3d8ccf4eca1","html_url":"https://github.com/hyperifyio/gnd","commit_stats":null,"previous_names":["hyperifyio/gnd"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hyperifyio/gnd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperifyio%2Fgnd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperifyio%2Fgnd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperifyio%2Fgnd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperifyio%2Fgnd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperifyio","download_url":"https://codeload.github.com/hyperifyio/gnd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperifyio%2Fgnd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28781308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T13:55:28.044Z","status":"ssl_error","status_checked_at":"2026-01-26T13:55:26.068Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","bitnet-llm","deterministic","functional-programming","llm","openai","openai-api","pipeline","programming-language","prompt-engineering"],"created_at":"2026-01-26T15:09:00.189Z","updated_at":"2026-01-26T15:09:00.869Z","avatar_url":"https://github.com/hyperifyio.png","language":"Go","readme":"Gendo is a locally executed, AI-assisted programming system whose \nimplementation files carry the `.gnd` extension.  It is designed so every phase \nof code generation and execution can run offline, with deterministic behaviour \nand no hidden state.  The format is deliberately minimal so that an AI can \ngenerate, analyse, and repair code automatically from high-level intent, while \nstill being straightforward for humans to inspect or hot-fix when necessary.\n\nThe tool-chain is delivered as three executables.  **`gndc`** is the compiler \nfront-end: it reads natural-language headers in `.llm` files and optional \nimplementation prompts in `.gnd.llm` files, expands those prompts with a local \nlanguage model, and writes the resulting `.gnd` implementation files.  \n**`gnd`** is the runtime interpreter that executes `.gnd` scripts or their \ncompact, text-based compiled form saved as `.gnc`.  **`gndtest`** is the test \nrunner.  Tests may be written as `.test.gnd.llm`, which the compiler converts \ninto executable `.test.gnd` pipelines, or as `.test.llm`, which the test runner \nevaluates directly with the language model.\n\nA unit comprises all files that share the same base name in one directory.  \nThe human-written header ends in `.llm` and records the unit's intent, \ndependencies, and constraints.  A prompt ending in `.gnd.llm` (optional) guides \nautomatic code generation.  The generated-or hand-edited-implementation is \nstored in `.gnd`; when compact distribution is desired, the interpreter can \nconvert that script to `.gnc`.  If several numbered fragments such as \n`010-sum.gnd`, `020-sum.gnd`, and `sum.gnd` exist, the build concatenates them \nin ascending numeric-prefix order, then appends any unnumbered fragment, then \nconcatenates numeric-suffix fragments like `sum-1.gnd`, `sum-2.gnd` in \nascending suffix order.  Case differences and dots in the base name are \nignored, so `010-Sum.gnd` and `sum.gnd` are merged into the same unit.\n\nInside a `.gnd` file each physical line (ignoring blank lines and comments) is \none instruction.  Lines beginning with `#` are comments.  Tokens are separated \nby spaces or horizontal tabs; an unescaped `#` terminates tokenisation for the \nrest of the line.  Identifiers begin with a letter, may contain letters, \ndigits, or hyphens, are case-insensitive, and never include dots or slashes.  \nThe single underscore `_` is reserved for the implicit data slot.  Literals are \ndecimal or hexadecimal integers, floating-point numbers, or double-quoted \nstrings with C-style escapes; string literals must close on the same line.\n\nAn instruction has the form\n\n    [ $destination ] opcode [ argument ... ] [# comment]\n\nIf the first token begins with `$` or is `_`, it is taken as the destination; \nthe second token must then be the opcode. Otherwise, the first token must be \nthe opcode and the destination is implicitly `_`. Writing `_` explicitly as the \ndestination is permitted and is synonymous with omitting the destination.\n\nAll variable references inside the argument list must use the `$` prefix. Bare \ntokens that are neither numeric literals, quoted strings, `$variables`, nor `_` \nmust be interpreted as string literals.\n\nData flows through `_`.  On entry, `_` holds the entire argument array passed \nto the unit.  Each instruction implicitly consumes `_` as its first input \n(unless further inputs are explicitly named) and binds its result to the \ndestination, which becomes the new `_`.  After the final instruction, whatever \nvalue resides in `_` is returned as the unit's result.  All other identifiers \nobey single assignment: they may be bound once and refer only to values defined \nearlier in the file.\n\nOnly spaces and tabs count as intra-line whitespace; other control characters \ncause a syntax error.  Lines end with LF (CR-LF is normalised).  There is no \nline-continuation escape-each physical line is complete.  A file is rejected if \nany identifier or literal breaks the token rules, a string literal is \nunterminated, a non-underscore identifier is rebound, a line has no opcode \nafter stripping comments, or disallowed control characters appear outside a \nstring.\n\nThis syntax definition contains no built-in operations; each opcode is resolved \nlater by the compiler and runtime.  Future extensions may add new literal kinds \nor inline attributes, provided they retain the one-line-per-instruction model, \nkeep `#` as the sole comment introducer, and preserve compatibility with \nexisting `.gnd` files.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperifyio%2Fgnd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperifyio%2Fgnd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperifyio%2Fgnd/lists"}