Skip to content

Getting Started with EPL

EPL — English Programming Language
Write code the way you think. In plain English.

1. Install EPL

EPL runs on Python 3.9+. Install it with pip:

pip install eplang

Verify the installation:

epl --version

2. Your First Program

Create a file called hello.epl:

Say "Hello, World!"

Run it:

epl hello.epl

Output:

Hello, World!

3. Core Language Concepts

Variables

name = "Alice"
age = 25
Say "Hello, " + name
Say "You are " + age + " years old"

Conditionals

score = 85

If score is greater than 90 then
    Say "Grade: A"
Otherwise
    Say "Grade: B"
End

Loops

Note: Count from 1 to 5
Repeat 5 times
    Say "Counting..."
End

Note: Loop over a list
fruits = ["apple", "banana", "mango"]
For Each fruit in fruits
    Say fruit
End

Functions

Function greet takes name
    Return "Hello, " + name + "!"
End

Say greet("World")

Classes

Class Animal
    Function Begin takes name
Note: [Parser Error]         this.name = name
    End

    Function speak
        Say this.name + " makes a sound"
    End
End

dog = New Animal("Rex")
dog.speak()

4. Use the Interactive REPL

The REPL lets you type and execute EPL code line by line:

epl repl

Useful REPL commands:

  • .vars — show all defined variables
  • .help — show available commands
  • .exit — quit

5. Create a Web Server

Start server on port 8080
    Route "/"
        Send "Welcome to my EPL web app!"
    End

    Route "/hello"
        Send "Hello from EPL!"
    End
Note: [Parser Error] End

Run it:

epl serve myapp.epl

6. Create a New Project

epl new myproject --template web
cd myproject
epl serve

7. CLI Quick Reference

epl <file.epl>           # Run a program
epl repl                 # Interactive REPL
epl new <name>           # Create new project
epl serve <file.epl>     # Start web server
epl build <file.epl>     # Compile to native binary
epl check <file.epl>     # Static type checking
epl fmt <file.epl>       # Format source code
epl install <package>    # Install a package

8. Try It in Your Browser

No installation needed — try EPL instantly at:

👉 EPL Online Playground

9. Next Steps

Resource Link
Official Book (PDF) epl_book.pdf
Language Reference language-reference.md
Tutorials tutorials.md
Architecture architecture.md
Package Manager package-manager.md
Changelog ../CHANGELOG.md

10. Get Help