Repository files navigation

Documentation
Continuous integration
Code coverage

Julia is a high-level, high-performance dynamic language for technicalcomputing. The main homepage for Julia can be found atjulialang.org. This is the GitHubrepository of Julia source code, including instructions for compilingand installing Julia, below.

• Homepage:https://julialang.org
• Binaries:https://julialang.org/downloads/
• Source code:https://github.com/JuliaLang/julia
• Documentation:https://docs.julialang.org
• Packages:https://julialang.org/packages/
• Discussion forum:https://discourse.julialang.org
• Zulip:https://julialang.zulipchat.com/
• Slack:https://julialang.slack.com (get an invite fromhttps://julialang.org/slack/)
• YouTube:https://www.youtube.com/user/JuliaLanguage
• Code coverage:https://coveralls.io/r/JuliaLang/julia

New developers may find the notes inCONTRIBUTINGhelpful to start contributing to the Julia codebase.

• Learning resources

If you would rather not compile the latest Julia from source,platform-specific tarballs with pre-compiled binaries are alsoavailable for download. Thedownloads page also provides details on thedifferent tiers of supportfor OS and platform combinations.

If everything works correctly, you will see a Julia banner and aninteractive prompt into which you can enter expressions forevaluation. You can read aboutgettingstarted in the manual.

Note: Although some OS package managers provide Julia, suchinstallations are neither maintained nor endorsed by the Juliaproject. They may be outdated, broken and/or unmaintained. Werecommend you use the official Julia binaries instead.

First, make sure you have all therequireddependencies installed.Then, acquire the source code by cloning the git repository:

git clone https://github.com/JuliaLang/julia.git

and then use the command prompt to change into the resulting julia directory. By default, you will be building the latest unstable version ofJulia. However, most users should use themost recent stable versionof Julia. You can get this version by running:

git checkout v1.11.2

To build thejulia executable, runmake from within the julia directory.

Building Julia requires 2GiB of disk space and approximately 4GiB of virtual memory.

Note: The build process will fail badly if any of the build directory's parent directories have spaces or other shell meta-characters such as$ or: in their names (this is due to a limitation in GNU make).

Once it is built, you can run thejulia executable. From within the julia directory, run

./julia

Your first test of Julia determines whether your build is workingproperly. From the juliadirectory, typemake testall. You should see output thatlists a series of running tests; if they complete without error, youshould be in good shape to start using Julia.

You can read aboutgettingstartedin the manual.

Detailed build instructions, should they be necessary,are included in thebuild documentation.

By default, Julia does not install anything outside the directory it was clonedinto and~/.julia. Julia and the vast majority of Julia packages can becompletely uninstalled by deleting these two directories.

The Julia source code is organized as follows:

The Julia REPL is quite powerful. See the section in the manual onthe Julia REPLfor more details.

On Windows, we highly recommend running Julia in a modern terminal,such asWindows Terminal from the Microsoft Store.

Support for editing Julia is available for manywidely used editors:Emacs,Vim,Sublime Text, and manyothers.

For users who prefer IDEs, we recommend using VS Code with thejulia-vscode plugin.
For notebook users,Jupyter notebook support is available through theIJulia package, andthePluto.jl package provides Pluto notebooks.