The fastest way to get a working Pharo environment: image (an object space with Pharo Core libraries) + virtual machine is to use Pharo Launcher. Pharo Launcher is a tool allowing you to easily download Pharo core images (Pharo stable version, Pharo development version, old Pharo versions, Pharo Mooc) and automatically get the appropriate virtual machine to run these images.

Installation

• Mac OS X: Double-click on the dmg file and drop Pharo Launcher app in Applications folder. Before being able to run Pharo Launcher, you may need to update temporarily your security settings: if you have Mac OS X 10.8 or higher then you might get a message saying that Pharo "can’t be opened because it is from an unidentified developer". This is due to the OS X Gatekeeper feature that is designed to discourage users from downloading from random locations and possibly installing something bad. Assuming you've downloaded Pharo Launcher from Pharo web site, then you have nothing to worry about, and you just need to bypass this warning:
  • Recommended - Right click (or command+click) the application icon and select "open"
  • Advanced - Enable all application downloads
    • In OS X go to the Apple Menu -> System Preferences -> Security & Privacy -> General ->
    • Unlock the padlock at the bottom of the window, which will require a computer admin password
    • Where it says "Allow applications downloaded from:" select "Anywhere"
    • OS X will give you a scary warning that is a bit exaggerated. If you're not comfortable with this, use the "right click" method mentioned above. In all cases OS X will still ask you if you want to open an "unsigned" application the first time it is opened, so new applications that are downloaded can't just start by themselves.
• Windows: Run the installer and follow instructions. Be sure to install Pharo Launcher in a place where you have write privileges.
• GNU/Linux: Unzip the archive in a place where you have write privileges.

Quick start

1. Run Pharo Launcher.
2. Choose your Pharo version or another template with additional content from the template list.
3. Click on create image (right-click on the template or button with a sun icon).
4. Once the image created, you can Launch it from the context menu in the right list. This will open the new image and close the launcher image. So you are ready to start working.

Which image to choose?

In Pharo, an image is the object space containing ALL the objects of the system: objects that are part of the Pharo runtime and development environment AND objects loaded / created by the user. By default, you should use the "current stable image: Pharo 7.0". You should now prefer 64-bit images over 32-bit images. You can use Pharo development image: Pharo 8 if you want to contribute to Pharo or you can’t wait to discover / use new Pharo features. You can also use any other template coming with preloaded libraries / tools according to your needs.

Initially on a new computer the right side with local images is empty. On the left side are the template images that are available on the web (there is also a local cache). Select the template image you want to use and download it. For instance you can download "Official distributions" -> "Pharo 7.0 (stable)" which is the latest stable image as of today. The launcher will download the image into a specific directory somewhere in your users home directory (you can configure where by clicking the Settings button at the bottom of the window). Each image gets its own folder. Use the "Show in folder" menu item if you want to open this location.

More documentation is available at https://github.com/pharo-project/pharo-launcher/.

Pharo standalone

You can download the Pharo VM and image as separated packages.

• Pharo image: 64bit (default) | 32bit

PharoVM 7.0 for Windows: 64bit | 32bit (default)

PharoVM 7.0 for macOS: 64bit (default) | 32bit

PharoVM 7.0 for Linux: 64bit (default) | 32bit

Command Line

# 64bit version
curl -L https://get.pharo.org/64/ | bash
# or if curl is not available:
wget -O- https://get.pharo.org/64 | bash

# 32bit version
curl -L https://get.pharo.org | bash
# or if curl is not available:
wget -O- https://get.pharo.org | bash