codesi-lang 0.0.1

First of its Kind Programming Language

🚀 Codesi Programming Language

The World's First Hinglish Programming Language with Revolutionary Features

Quick Start • Documentation • Features • Examples • Contributing

---

🌟 What Makes Codesi Revolutionary?

Codesi isn't just another programming language—it's a paradigm shift in how we think about code. Created by a 15-year-old developer on a mobile phone, it introduces multiple world-first features that have never existed in any programming language before.

🎯 Core Innovation

• 🇮🇳 Hinglish Syntax: First programming language with native Hindi-English hybrid syntax
• 🪄 JAADU Auto-Correction: Intelligent, context-aware error correction built into the language itself
• 🧠 Self-Explaining Code: No AI/ML needed—the language explains itself natively
• ⏰ Time Machine Debugger: Travel through execution history, modify past states
• 📚 Smart History: Complete execution timeline with state snapshots
• 💡 Personalized Hints: Context-aware suggestions for common patterns

---

🚀 Quick Start

Installation

🪟 Windows Users (Recommended)

Easiest Method - One-Click Installer:

1. Go to Releases
2. Download the latest Codesi Setup.exe
3. Run the installer
4. Access Codesi from:
   • 🖥️ Desktop Icon
   • 📋 Start Menu
   • ⌨️ CMD/PowerShell (type codesi)

If CMD access not working:

Press Win + R and paste this command:

powershell -NoProfile -Command "$add='C:\Program Files\Codesi'; $p=[Environment]::GetEnvironmentVariable('Path','User'); if(-not $p){ [Environment]::SetEnvironmentVariable('Path',$add,'User') } elseif($p -notlike '*'+$add+'*'){ [Environment]::SetEnvironmentVariable('Path',$p + ';' + $add,'User') }; Start-Process -FilePath 'RUNDLL32.EXE' -ArgumentList 'USER32.DLL,SendMessageA 0xFFFF,0x1A,0,`'Environment`'' -NoNewWindow"

Restart CMD and type codesi - it will work!

---

🍎 macOS / 🐧 Linux Users

Installer Coming Soon! (In development)

For now, use Python installation:

# Install Python (if not installed)
# macOS: brew install python
# Linux: sudo apt install python3

# Install Codesi via pip
pip install codesi

# Access Codesi
codesi

---

📱 Android Users (Termux)

# 1. Install Termux from Play Store or F-Droid
# 2. Open Termux and run:

apt update && apt upgrade -y
pkg install python
pip install codesi

# Access Codesi
codesi

---

🌐 Need Help?

Visit our official website: https://thecodesi.xyz

Complete installation guides and troubleshooting available!

Your First Program

Create hello.cds:

likho("Hello, World!")
naam = input_lo("Aapka naam kya hai? ")
likho("Namaste, " + naam + "!")

Run it:

codesi hello.cds

Or use interactive mode:

codesi

---

🌍 World-First Features

1️⃣ 🪄 JAADU - Auto-Correction System

First programming language with built-in auto-correction

# You type (with typo):
linkho("Hello")  

# JAADU automatically corrects to:
🪄 JAADU: 'linkho' → 'likho'

Enable JAADU mode:

codesi --jaadu

2️⃣ ⏰ Time Machine Debugger

First language with execution time travel

time_machine_on()  # Activate time travel

x = 5
likho(x)           # Prints: 5

x = 10
likho(x)           # Prints: 10

peeche()           # Go back in time!
likho(x)           # Prints: 5 (traveled back!)

aage()             # Go forward
timeline()         # See complete execution history

Real-world use case:

time_machine_on()

arr = [1, 2, 3]
arr.push(4)
arr.push(5)
likho(arr)  // [1, 2, 3, 4, 5]

peeche(2)   // Go back 2 steps
likho(arr)  // [1, 2, 3] (before pushes!)

3️⃣ 🧠 Samjhao - Self-Explaining Code

First language that explains itself without external AI

samjhao_on()  # Enable explanation mode

x = 10
y = 20
result = x + y
likho(result)

samjhao()  # Get detailed explanation

Output:

📖 Code Explanation:
============================================================
1. Variable 'x' mein value 10 store ki
2. Variable 'y' mein value 20 store ki
3. 🔢 Operation: 10 + 20 = 30
4. Variable 'result' mein value 30 store ki
============================================================

4️⃣ 🇮🇳 Hinglish Syntax

First language designed for Indian developers

// Variables (English or Hindi)
naam = "Rishaank"
age = 15

// Conditions (Hinglish)
agar (age < 18) {
    likho("Aap minor ho")
} nahi_to {
    likho("Aap adult ho")
}

// Loops (Natural Hinglish)
har i se 1 tak 5 {
    likho("Number: " + i)
}

// Functions (Intuitive)
karya greet(naam) {
    vapas "Namaste, " + naam
}

---

🎓 Real-World Examples

Example 1: Student Management System

class Student {
    banao(naam, roll, marks) {
        ye.naam = naam
        ye.roll = roll
        ye.marks = marks
    }
    
    karya calculate_grade() {
        agar (ye.marks >= 90) {
            vapas "A+"
        } ya_phir (ye.marks >= 75) {
            vapas "A"
        } ya_phir (ye.marks >= 60) {
            vapas "B"
        } nahi_to {
            vapas "C"
        }
    }
    
    karya display() {
        likho("Student:", ye.naam)
        likho("Roll:", ye.roll)
        likho("Marks:", ye.marks)
        likho("Grade:", ye.calculate_grade())
    }
}

// Create students
s1 = new Student("Rishaank", 1, 95)
s2 = new Student("Raj", 2, 78)

// Display info
s1.display()
s2.display()

Example 2: Time Machine Debugging

time_machine_on()

// Buggy code - let's debug it
balance = 1000
likho("Initial:", balance)

balance -= 200  // Withdrawal
likho("After withdrawal:", balance)

balance -= 500  // Another withdrawal
likho("After 2nd withdrawal:", balance)

balance -= 400  // ERROR: Insufficient balance!

// Go back and check
peeche(2)
likho("Checking balance:", balance)  // 800

// See complete timeline
timeline()

Example 3: File Processing with SAMJHAO

First, create students.txt with this data:

Rishaank,95
Raj,78
Priya,82
Amit,65
Neha,91

Now run this code:

// Enable explanations
samjhao_on()

// Read and process file
try {
    data = file_padho("students.txt")
    lines = data.todo("\n")
    
    likho("=== Student Results ===")
    
    // Process each line
    har line mein lines {
        agar (line != "") {
            parts = line.todo(",")
            naam = parts[0]
            marks = int_bnao(parts[1])
            
            agar (marks >= 75) {
                likho(naam, "passed with", marks, "marks! ✅")
            } nahi_to {
                likho(naam, "needs improvement -", marks, "marks")
            }
        }
    }
} catch(error) {
    likho("Error:", error.message)
    likho("Hint: students.txt file banao pehle!")
}

// See what happened
samjhao()

Expected Output:

=== Student Results ===
Rishaank passed with 95 marks! ✅
Raj passed with 78 marks! ✅
Priya passed with 82 marks! ✅
Amit needs improvement - 65 marks
Neha passed with 91 marks! ✅

📖 Code Explanation:
============================================================
1. File 'students.txt' successfully read
2. Data split into 5 lines
3. Each line processed for name and marks
4. Conditions evaluated for pass/fail
5. Results displayed with formatting
============================================================

---

🎮 Interactive REPL Mode

$ codesi
======================================================================
  🚀 Codesi Programming Language - Interactive Mode
  Version 1.0.0 | Hinglish Programming Language
======================================================================

📚 Commands:
  help()                       // Show this help                 
  qhelp()                      // Show quick reference            
  license()                    // Show license info   
  copyright()                  // Show copyright info     
  credits()                    // Show credits & thanks            
  exit() or quit()             // Exit REPL 
  clear()                      // Clear screen 
  vars()                       // Show all variables   
  history()                    // Show command history 
  !!                           // Repeat last command 
  !5                           // Repeat command #5 from history   

codesi:1> naam = "Rishaank"
codesi:2> likho("Hello, " + naam)
Hello, Rishaank
codesi:3> vars()

📊 Current Variables:
  naam = 'Rishaank'

---

🛠️ Built-in Functions

Output Functions

likho("Hello")           // Print output

Input Functions

naam = input_lo("Name: ")          // String input
age = int_lo("Age: ")           // Integer input
score = float_lo("Score: ")     // Float input

Math Functions

math_absolute(-5)        // 5
math_square(16)          // 4
math_power(2, 3)         // 8
math_random(1, 10)       // Random number
math_gol(3.7)            // 4 (round)

Type Functions

type_of(value)           // Get type
string_bnao(123)         // "123"
int_bnao("456")          // 456
float_bnao("3.14")       // 3.14
bool_bnao(1)             // sach

Array/String Functions

lambai(arr)              // Length
range(1, 10)             // [1,2,3...9]

---

📚 Documentation

Comprehensive guides for all skill levels:

• Installation Guide - Setup instructions
• Quickstart Guide - Get started in 5 minutes
• Syntax Guide - Complete syntax reference
• Complete Basics - Beginner tutorials
• Complete Intermediate - Advanced concepts
• Advanced Features - Time Machine, JAADU, Samjhao
• OOP Guide - Object-oriented programming
• Functions - Function reference
• Built-in Functions - Standard library

---

🎯 Use Cases

Perfect For:

✅ Education - Teaching programming in Hindi/Hinglish
✅ Rapid Prototyping - Fast development with auto-correction
✅ Debugging - Time Machine makes debugging trivial
✅ Learning - Self-explaining code helps understanding
✅ Indian Developers - Natural syntax for Hindi speakers

---

🌟 Why Codesi?

Feature	Traditional Languages	Codesi
Language Barrier	English only	Hinglish (Hindi + English)
Error Correction	Manual debugging	Auto-correction (JAADU)
Code Understanding	External documentation	Self-explaining (Samjhao)
Time Travel Debugging	None	Built-in Time Machine
Learning Curve	Steep	Gentle with hints
Cultural Relevance	Western-centric	India-first design

---

🤝 Contributing

We welcome contributions! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

---

📝 License

Codesi is open-source software licensed under the MIT License.

🛡️ Security

If you discover any security vulnerabilities, please report them responsibly by following the guidelines in SECURITY.md.

📜 Changelog

Stay updated with the latest changes and improvements by checking our CHANGELOG.md.

🙏 Acknowledgements

A huge thank you to Rishaank Gupta for his vision and dedication in creating Codesi. This project is a testament to what passion and innovation can achieve.