Getting Started

Get Rampyaaryan running on your machine in under 5 minutes. Choose the installation method that suits your platform.

Installation

Windows

# Option 1: Download pre-built binary from Releases
# https://github.com/Rampyaaryans/rampyaaryan/releases

# Option 2: Build from source (MinGW/MSYS2)
git clone https://github.com/Rampyaaryans/rampyaaryan.git
cd rampyaaryan
gcc -O2 -o rampyaaryan.exe src\memory.c src\value.c src\object.c src\table.c src\chunk.c src\lexer.c src\compiler.c src\vm.c src\native.c src\debug.c src\ascii_art.c src\main.c -lm

Linux

# Option 1: Download binary
curl -L https://github.com/Rampyaaryans/rampyaaryan/releases/latest/download/rampyaaryan-linux-x64 -o rampyaaryan
chmod +x rampyaaryan
sudo mv rampyaaryan /usr/local/bin/

# Option 2: Build from source
git clone https://github.com/Rampyaaryans/rampyaaryan.git
cd rampyaaryan
make
sudo make install

macOS

curl -L https://github.com/Rampyaaryans/rampyaaryan/releases/latest/download/rampyaaryan-macos-x64 -o rampyaaryan
chmod +x rampyaaryan
sudo mv rampyaaryan /usr/local/bin/

Using CMake

git clone https://github.com/Rampyaaryans/rampyaaryan.git
cd rampyaaryan
mkdir build && cd build
cmake ..
cmake --build .

Verify Installation

rampyaaryan --version
# Output: Rampyaaryan v3.5.2 (bytecode VM, built ...)

---

Your First Program

Create a file called namaste.ram:

likho "🙏 Namaste Duniya!"
likho "Mera naam Rampyaaryan hai!"

Run it:

rampyaaryan namaste.ram

Output:

🙏 Namaste Duniya!
Mera naam Rampyaaryan hai!

---

Interactive REPL

Start Rampyaaryan without any file to enter the interactive REPL (Read-Eval-Print Loop):

rampyaaryan

Type expressions and see results immediately:

rpy> likho 2 + 3
5
rpy> maano naam = "Aryan"
rpy> likho "Hello, " + naam
Hello, Aryan
rpy> likho factorial(10)
3628800

REPL Commands

Command	Description
.help	Show all keywords and built-in functions
.clear	Clear screen
.memory	Show memory usage statistics
.version	Show version information
.exit	Quit REPL

---

Language Basics

Variables

maano naam = "Rampyaaryan"     # string
maano umar = 25               # number
maano active = sach           # boolean (true)
maano data = khali            # null
maano fruits = ["seb", "kela"]  # list
maano info = {"key": "val"}   # map

Data Types

Type	Hindi Name	Examples
Number	sankhya	42, 3.14, -7
String	shabd	"hello", "namaste"
Boolean	bool	sach (true), jhooth (false)
Null	khali	khali
List	suchi	[1, 2, 3]
Function	kaam	kaam add(a, b) { ... }
Map/Dict	shabdkosh	{"key": "value"}

Print & Input

likho "Namaste!"                # print
likho "Sum:", 2 + 3             # multiple values

maano naam = poocho("Name: ")  # read input
maano umar = sankhya(poocho("Umar: "))

Conditions

agar umar >= 18 {
    likho "Vote de sakte ho"
} warna agar umar >= 13 {
    likho "Teenager ho"
} warna {
    likho "Chote ho"
}

Loops

# While loop
maano i = 0
jab tak i < 5 {
    likho i
    i = i + 1
}

# For loop
har i = 1; i <= 10; i = i + 1 {
    likho i
}

Functions

kaam factorial(n) {
    agar n <= 1 { wapas do 1 }
    wapas do n * factorial(n - 1)
}

likho factorial(10)   # 3628800

Lists

maano fruits = ["seb", "kela", "aam"]
joodo(fruits, "santara")     # append
likho fruits[0]               # "seb"
likho lambai(fruits)          # 4

Maps / Dictionaries

maano student = {"naam": "Aryan", "umar": 20}
likho student["naam"]         # "Aryan"
likho chabi(student)          # ["naam", "umar"]

---

Next Steps