Install Mojo

You can install Mojo as a Python or Conda package. This page shows you how to install using pixi and uv, but you can use other tools.

For a beginner's guide to Mojo, instead see the get started tutorial, which includes installation steps.

System requirements

You can use Mac, Linux, or Windows with WSL. For details, see the system requirements.

Install

To get the latest version, we recommend installing our nightly build. If you want a better tested but older version, install the stable build. Both options are shown below.

For the most reliable experience, we recommend using Pixi. It's both a package manager and virtual environment manager—which alone makes development a lot easier—but it's also fast, language agnostic, and provides lock files for package dependencies. For more help with it, see our Pixi basics guide.

pixi
uv

If you don't have it, install pixi:

curl -fsSL https://pixi.sh/install.sh | sh

Navigate to the directory where you want to create a project and run this:
```
pixi init hello-world \
  -c https://conda.modular.com/max-nightly/ -c conda-forge \
  && cd hello-world
```
This creates a project directory named hello-world, adds the channel for Modular conda packages, and enters the directory.

Tip: You can remove the -c options if you specify default channels.

Install Mojo (stableTo get the nightly build, change the version in the website header.):
```
pixi add "mojo==0.26.2"
```

Enter the virtual environment so you can access the mojo CLI:
```
pixi shell
```

If you don't have it, install uv:
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
Then restart your terminal to make uv accessible.
Create a project:
```
uv init hello-world && cd hello-world
```
Create and start a virtual environment:
```
uv venv && source .venv/bin/activate
```

Install Mojo (stableTo get the nightly build, change the version in the website header.):
```
uv pip install mojo \
  --extra-index-url https://modular.gateway.scarf.sh/simple/
```

Verify your installation by printing the Mojo version:

mojo --version

Add the VS Code extension

If you're using Visual Studio Code or another IDE derived from it (such as Cursor), we recommend installing the Mojo extension, which provides features like syntax highlighting, code completion, and debugging support. You can install it from either:

The Visual Studio Code Marketplace, for VS Code users
The Open VSX Registry, for users of Cursor and other editors that support VS Code extensions

Or, open the Extensions view in your IDE and search for "Mojo"—make sure you install the extension from Modular.

Prior to the 0.25.6 Mojo release, there were two versions of the Mojo extension: a stable version for working with the stable build of Mojo and a nightly version for working with the nightly build of Mojo. Concurrent with the 0.25.6 Mojo release, we've consolidated the two versions into a single extension that works for both stable and nightly builds.

The new extension replaces the old stable version, so if you have the stable version installed, you can simply update it to receive the new version. If you have the nightly version of the extension installed, you should uninstall it and install the regular (non-nightly) version.

Print "Hello world"

If you followed the installation steps above, your terminal should be in an environment with mojo installed. To run some code, you just need a .mojo file with a main() function:

Create a file named hello.mojo with this code:
hello.mojo
```
def main() raises:
    print("Hello, World!")
```
Run it with the mojo CLI:
```
mojo hello.mojo
```
```
Hello, World!
```

Try Mojo agent skills

Use Mojo agent skills with your AI tools to generate more accurate Mojo code while learning Mojo:

npx skills add modular/skills

Try some examples

The examples/mojo/ directory of our public GitHub repository contains several examples of Mojo code that you can use to learn more about the language and its standard library. Here's how to download and use them.

Clone the repository:

git clone https://github.com/modular/modular.git

Navigate to one of the Mojo example subdirectories, such as the subdirectory containing the reference solution for the Get started with Mojo tutorial project, which is an implementation of Conway's Game of Life cellular automation:
```
cd modular/mojo/examples/life
```
Use pixi to download and install the dependencies for the project and to build and run the examples. For example, to run the reference solution for the Game of Life tutorial project, use the following command:
```
pixi run lifev1
```
This displays a window that shows an initial random state for the grid and then automatically updates it with subsequent generations. Quit the program by pressing the Q or Esc key or by closing the window.
If you're using a package manager other than pixi, make sure mojo is installed and accessible in your current shell environment. Consult the README.md file in the example project subdirectory for information about any other dependencies that need to be installed for that particular example project. (The Game of Life example requires a compatible Python runtime and the pygame-ce library.) Then run the example with the mojo CLI. For example, to run the reference solution for the Game of Life tutorial project, use the following command:
mojo lifev1.mojo

Update

The following commands should update your local mojo package if a new version is available that's compatible with the version you specified when you installed it or added it as a package dependency. For more information about updating packages, see the docs for your package manager.

pixi
uv

pixi update mojo

uv sync --upgrade-package mojo

Uninstall

Mojo is installed as a Python or Conda package, so the normal package removal process applies.

pixi
uv

This removes the package from your local project:

pixi remove mojo

This deactivates your virtual environment:

exit

This removes the package from your local environment:

uv pip uninstall mojo && uv sync

This deactivates your virtual environment:

deactivate

System requirements

Relocated to the system requirements page.

Install​

Add the VS Code extension​

Print "Hello world"​

Try Mojo agent skills​

Try some examples​

Update​

Uninstall​

System requirements​

Install

Add the VS Code extension

Print "Hello world"

Try Mojo agent skills

Try some examples

Update

Uninstall

System requirements