🎃 Pumpkin: Code for Humans

The programming language that grows your ideas. v0.1.8 - The Foundation Release

Pumpkin is a programming language built for humans, not robots. It removes the scary symbols and confusing jargon, replacing them with clear instructions that make sense the first time you read them.

Try the Playground (Runs entirely in your browser!)

Pumpkin is powered by modern, safe, and high-performance technologies:

• Core Engine: A high-performance bytecode VM and compiler.
• CLI & REPL: Providing a friendly and stable developer interface.
• WASM Bridge: Seamless execution in both Node.js and the browser.
• Website: A lightning-fast documentation and playground site.

Pumpkin is designed for Creative Coding, Learning, and Exploration.

• Algorithmic Art: Generate patterns which you can see in our "Use Cases" page.
• Text Adventures: Create interactive stories with simple logic.
• Math Experiments: Visualize algorithms and solve problems playfully.
• Learning Basics: Master loops, variables, and conditions without the headache.

You can install the Pumpkin CLI via npm. It works on any machine with Node.js installed.

npm install pumpkin-lang

View on npmjs.com

Verify the installation:

npx pumpkin --version
# Output: 🎃 Pumpkin v0.1.8

To get file icons and syntax highlighting, install our official extension:

1. Search for "Pumpkin Language Support" in the VS Code Extensions view.
2. Or visit the VS Code Marketplace (Click here to install).
3. Click Install.

Just type npx pumpkin repl to start playing immediately.

$ npx pumpkin repl
Welcome to Pumpkin v0.1.8 🎃
> show "Hello World"
"Hello World"
> let x = 10
> show x * 2
20

Create a file named hello.pumpkin:

// hello.pumpkin
let name = "Developer"
show "Hello, " + name + "!"

let count = 0
repeat 3 {
    count = count + 1
    show count
}

Run it:

npx pumpkin run hello.pumpkin

Pumpkin allows you to write basic algorithmic logic with a smile.

• Variables: let x = 10, let name = "Pumpkin"
• Math: +, -, *, /, ( ) (Human-readable math)
• Logic: if, else, and, or, not
• Loops: while, repeat
• Output: show "text"
• Standard Lib: Basic math and logic modules.
• Comments: // This is a comment

To keep v0.1 stable, we intentionally excluded:

• ❌ User-defined Functions
• ❌ Arrays / Lists
• ❌ File I/O
• ❌ Imports (Partially supported in standard lib)

These are actively being worked on! See our Roadmap.

We love contributors! This project is a great place to learn about language design, Rust, and WASM.

• Core: Written in Rust (/pumpkin_core). compiled to WASM.
• CLI: Written in TypeScript (/src/cli). Wraps the WASM core.
• Website: Next.js + React (/website). Hosted on Vercel.

1. Prerequisites: Node.js (v18+), Rust (latest stable), wasm-pack.

2. Build Core:

   cd pumpkin_core
   wasm-pack build --target nodejs --out-dir ../dist/pkg

3. Run Tests:

   ./tests/run_smoke_test.sh

Pumpkin is released under the MIT License and the GNU GPL v3. You may choose either license to govern your use of the software.

Trademark Notice: The name "Pumpkin", and the "Pumpkin." logo are trademarks of Citrullix Inc. Use of these marks in derivative works requires explicit permission to avoid community confusion.

Made with 🎃 for the next generation of coders.