Skip to content
Open Source·

Gagan-lang

A minimal programming language with its own syntax, interpreter, and PyPI distribution. Runs .ggn files from the terminal.

PythonPyPIInterpreter DesignCLI

Gagan-lang

A programming language I built from scratch. It has its own syntax, an interpreter written in Python, and is distributed as a PyPI package. You install it, write .ggn files, and run them from the terminal.

Install

pip install gagan-lang

Run a script

ggn hello.ggn

Check version

ggn --version

Syntax

gprint "Hello, World!"
gscan name
result = 5 + 3
if result > 7 { gprint "big" } else { gprint "small" }

Language features

  • gprint — print to stdout
  • gscan — read user input
  • Variable assignment with =
  • Basic arithmetic (+, -, *, /)
  • Conditional statements (if / else with block syntax)

Why I built it

Partly to understand how interpreters work — tokenization, parsing, AST evaluation. Partly because I wanted a language where the syntax feels obvious enough that someone with zero programming experience could read it and guess what it does. The whole interpreter is under 500 lines of Python.

Links