https://github.com/pritpatel2412/kemlang
🧠 Learn to code with desi vibes using Gujarati keywords like sharu, jo, lakho, samaapt & more! ⚙️ Built with: Python 🐍 + FastAPI 🚀 + React ⚛️ 🎮 Try it live:
https://github.com/pritpatel2412/kemlang
compiler-design interpreter kemlang opensource parser programming-language python3 react
Last synced: about 2 months ago
JSON representation
🧠 Learn to code with desi vibes using Gujarati keywords like sharu, jo, lakho, samaapt & more! ⚙️ Built with: Python 🐍 + FastAPI 🚀 + React ⚛️ 🎮 Try it live:
- Host: GitHub
- URL: https://github.com/pritpatel2412/kemlang
- Owner: pritpatel2412
- License: mit
- Created: 2025-06-13T13:31:26.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-12-19T13:00:38.000Z (6 months ago)
- Last Synced: 2025-12-22T04:58:30.402Z (6 months ago)
- Topics: compiler-design, interpreter, kemlang, opensource, parser, programming-language, python3, react
- Language: JavaScript
- Homepage: https://kemlang.vercel.app/
- Size: 3.53 MB
- Stars: 6
- Watchers: 0
- Forks: 0
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🇮🇳 KemLang ✨
*A Gujarati-Inspired Toy Programming Language with a Smile 😄*
KemLang makes programming fun, cultural, and beginner-friendly.
Blending playful Gujarati syntax with modern tools, it's perfect for learners who want to code in a language that feels close to home.
---
## 🌟 Features You’ll Love
* ✅ **Gujarati-style syntax** (`sharu`, `samaapt`, `lakho`, etc.)
* 🧠 **Simple, English-like constructs** to help beginners get started fast
* 🚀 **Complete interpreter pipeline** (Lexer → Parser → Evaluator)
* 💻 **CLI support** for executing `.kem` files effortlessly
* 🌐 **Web API powered by FastAPI** for remote execution
* 🤪 **Playful Gujarati error messages** for a cultural twist
> 💬 “Kem cho, developer? Let’s make code feel like garba!”
---
## 📦 Installation
Get started in seconds with either of these:
### 🧰 Option 1: Install globally
```bash
npm install -g kemlang
```
### ⚡ Option 2: Run instantly with `npx`
```bash
npx kemlang yourfile.kem
```
---
## 🎯 Quick Example
👩💻 Let’s write your first KemLang program!
### 1. Create `hello.kem`
```kemlang
sharu {
do naam = "KemLang";
lakho("Kem cho " + naam);
} samaapt
```
### 2. Run it
```bash
kemlang hello.kem
```
### 3. Output
```
Kem cho KemLang
```
👏 That’s it! You just coded in KemLang!
---
## 📜 Language Reference
| 💬 English | 💻 KemLang Syntax |
| --------------- | ------------------- |
| Start Block | `sharu {` |
| End Block | `} samaapt` |
| Print Statement | `lakho()` |
| Print Example | `lakho("Hello");` |
| Variable | `do` |
| Variable Ex. | `do x = 10;` |
| If / Else | `jo / nahitar` |
| If Example | `jo (x > 5) {}` |
| While Loop | `jyaare` |
| While Example | `jyaare (x < 5) {}` |
> 📖 **Pro Tip**: It’s not just code. It’s a *varta* (story) your computer understands!
---
## 🛠 Development
Want to contribute or hack around? Here’s how:
### 1. Clone the repo
```bash
git clone https://github.com/yourusername/kemlang.git
```
### 2. Install dependencies
```bash
npm install
```
### 3. Run the test suite
```bash
npm test
```
### 4. Run locally in VS Code
**Frontend**
* Open the terminal in VS Code (`Ctrl + ~` or `Cmd + ~`).
* Navigate to the frontend directory (e.g., `cd frontend` if applicable).
* Run the frontend development server:
```bash
npm run dev
```
* Open your browser and go to the URL displayed in the terminal (usually `http://localhost:3000`).
**Backend**
* Open a new terminal in VS Code.
* Navigate to the backend directory (e.g., `cd backend` if applicable).
* Ensure you have Python and FastAPI installed. If not, install dependencies:
```bash
pip install fastapi uvicorn
```
* Run the backend server with auto-reload:
```bash
uvicorn cli:app --reload
```
* The API will be available at `http://localhost:8000` (or the port specified in your configuration).
---
## 📄 License
This project is licensed under the **MIT License**. See `LICENSE` for full details.
---
## 🙏 Credits
KemLang is lovingly inspired by:
* 🧑🤝🧑 BhaiLang
* 🌍 The Vernacular Programming Movement
* ⚓️ Gujarati Culture & Language
---
## 💫 Kem cho? Happy Coding! 🙌
**Let your code speak your culture** 🧡