MyanCode · မြန်မာကုဒ် (Python Edition)

A Burmese natural language programming language for beginners — rewritten in Python. Write code in Myanmar script — MyanCode understands it, transpiles it to Python, and runs it.

This is a Python port of the original MyanCode JavaScript implementation.

What is MyanCode?

MyanCode is a multi-paradigm programming language written entirely in the Burmese (Myanmar) language. Students write code like this:

score ကို ၇၅ အဖြစ်သတ်မှတ်ပါ
အကယ်၍ score က ၈၀ ထက်ကြီးရင်
  ပြောပါ "ဂုဏ်ထူး"
မဟုတ်ရင်
  ပြောပါ "ပျမ်းမျှ"
ပြီးပါပြီ

Which runs as:

ပျမ်းမျှ

How It Works

MyanCode uses a 6-stage NLP pipeline:

[Burmese source .myan]
        ↓
[1] Tokenizer       — splits text into typed tokens (lexical analysis)
        ↓
[2] Classifier      — identifies the intent of each line (text classification)
        ↓
[3] Extractor       — pulls out variable names, values, operators (NER)
        ↓
[4] AST Builder     — assembles lines into a nested syntax tree (syntactic parsing)
        ↓
[5] Transpiler      — converts the tree to Python (language generation)
        ↓
[6] Runtime         — executes via Python subprocess, captures output

Installation

Requires Python 3.10+.

cd myancode-python
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# or: pip install -e ".[dev]"

Usage

Run a .myan file

python src/cli.py examples/hello.myan
# or after pip install -e .
myancode examples/hello.myan

CLI options

myancode --transpile examples/hello.myan   # print generated Python
myancode --ast examples/hello.myan         # print AST JSON
myancode --repl                            # interactive REPL
myancode --ide                             # browser IDE
myancode --version

Browser IDE

Recommended (avoids conflict with the Node.js myancode on your PATH):

./myancode --ide              # from project root — always Python
# or
source scripts/activate.sh    # venv + fixes PATH vs nvm
myancode --ide
# or
.venv/bin/myancode --ide
myancode-py --ide             # after pip install -e .

Open http://127.0.0.1:3000. The editor is on top; OUTPUT, SIMULATION, and PYTHON are below. The right Chat panel writes MyanCode (needs OPENROUTER_API_KEY in .env — see .env.example).

Node vs Python myancode

If you have the old Node.js MyanCode installed (npm install -g myancode), the global myancode command opens https://myan-code.vercel.app (JavaScript IDE). The Python edition uses a local server instead.

To remove the conflict entirely:

npm uninstall -g myancode
pip install -e .
source scripts/activate.sh
myancode --version   # should print 2.3.0

Docs

• Tutorial — မြန်မာဘာသာ သင်ခန်းစာ
• NLP stages — Tokenizer မှ Runtime အထိ မြန်မာဘာသာ ရှင်းလင်းချက်
• Lesson plan — ဆရာ/ဆရာမ သင်ကြား မှတ်စု
• Language reference — full keyword table
• LICENSE — MIT

Project Structure

myancode-python/
├── bin/myancode
├── config/                  # keywords + error messages (dev)
├── docs/                    # tutorial + language reference
├── examples/                # sample .myan programs
├── src/
│   ├── cli.py
│   ├── engine/              # tokenizer → runner pipeline
│   │   └── data/            # packaged copy of config JSON
│   └── ide/                 # Flask IDE + public/index.html
└── tests/                   # pytest suite

Tests

source .venv/bin/activate
pytest -q

License

MIT