// readme

Marsha AI Language

Marsha is an LLM-based programming language. Describe what you want done with a simple syntax, provide examples of usage, and the Marsha compiler will guide an LLM to produce tested Python software.

Usage

The Marsha compiler can be used to compile the syntax using a uv-installed package via a terminal or Jupyter Notebook:

uv pip install git+https://github.com/alantech/marsha
python -m marsha compile data_mangling.mrsh

From a source checkout you can instead install a marsha command directly:

make install    # Linux / macOS
install.bat     # Windows

This builds a virtualenv with Marsha in it and drops a small launcher script at ~/.local/bin/marsha (~/.local/bin/marsha.bat on Windows; override the location with make install PREFIX=/usr/local or install.bat C:\tools) that simply runs python -m marsha from that virtualenv, passing your arguments through. The venv location can be overridden per-invocation with the MARSHA_VENV environment variable, and make uninstall / uninstall.bat remove the launcher.

Syntax

The Marsha syntax looks a lot like markdown and is a mixture of English and mathematical notation.โ€ฆ