📦 Installation Guide

Get Whisper up and running in minutes

⚙️ Requirements

System Requirements

  • Python: 3.7 or higher
  • Operating System: Windows, macOS, or Linux
  • Dependencies: None (Whisper has no external dependencies!)

Before installing Whisper, make sure you have Python installed on your system. You can check your Python version by running: 

python --version

or

python3 --version

🚀 Quick Installation

The easiest way to install Whisper is using pip:

1 Install via pip

pip install whisper-lang

2 Verify Installation

After installation, verify that Whisper is installed correctly:

whisper --version
✅ If installation was successful, you should see: Whisper v1.0.0

📥 Installation from Source

If you want to install Whisper from source or contribute to development:

1 Clone the Repository

git clone https://github.com/ibrahim787898m/whisper-lang.git
cd whisper

2 Install in Development Mode

pip install -e .

This will install Whisper in editable mode, allowing you to make changes to the source code.

🎯 Running Your First Program

Once installed, you can run Whisper programs using the whisper command:

Create a Hello World Program

Create a file named hello.wsp or hello.whisper with the following content: 

whisper "Hello, World!"
whisper "Welcome to Whisper programming!"

Run the Program

whisper hello.wsp

or

whisper hello.whisper
🎉 Congratulations! You've just run your first Whisper program!

🎨 Setting Up VS Code (Optional)

For the best development experience, install the Whisper extension for Visual Studio Code:

1 Install from VS Code Marketplace

The easiest way to install Whisper is directly from the VS Code Marketplace:

Option A: Install via VS Code

  1. Open Visual Studio Code
  2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
  3. Search for "Whisper"
  4. Click "Install"

Option B: Install via Command Line

code --install-extension ibrahimmustafaopu.whisper-lang-support

Option C: Install from Marketplace Website

View in Marketplace →

1 Install VS Code

Download and install Visual Studio Code from code.visualstudio.com

2 Install Whisper Extension

Copy the Whisper extension folder to your VS Code extensions directory:

  • Windows: %USERPROFILE%\.vscode\extensions\
  • macOS/Linux: ~/.vscode/extensions/

3 Reload VS Code

Restart VS Code to activate the Whisper extension. You'll now have syntax highlighting for .wsp and .whisper files!

❓ Troubleshooting

Command Not Found

If you get a "command not found" error after installation:

Permission Errors

If you encounter permission errors during installation:

💡 Tip: Using a virtual environment is recommended for Python projects. Create one with python -m venv venv

🎓 Next Steps

Now that you have Whisper installed, here's what to do next:

  1. Start the Tutorial - Learn Whisper step by step
  2. Browse Examples - See real Whisper programs in action
  3. Read the Docs - Complete language reference
  4. Join the Community - Contribute and get help