Skip to content

starkware-libs/cairo-lang

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8276ac3 · Jan 26, 2025

History

75 Commits
Jan 26, 2025
Aug 18, 2024
Jan 26, 2025
Feb 22, 2023
Mar 13, 2022
Jun 13, 2021
Jan 26, 2025
Mar 5, 2024
Feb 12, 2024
Jan 26, 2025
Jan 26, 2025
Nov 16, 2023
May 7, 2023
Mar 5, 2024
Nov 28, 2023
May 7, 2023
Feb 22, 2023

Repository files navigation

Introduction

Cairo is a programming language for writing provable programs.

Documentation

The Cairo documentation consists of two parts: "Hello Cairo" and "How Cairo Works?". Both parts can be found in https://cairo-lang.org/docs/.

We recommend starting from Setting up the environment.

Installation instructions

You should be able to download the python package zip file directly from github and install it using pip. See Setting up the environment.

However, if you want to build it yourself, you can build it from the git repository. It is recommended to run the build inside a docker (as explained below), since it guarantees that all the dependencies are installed. Alternatively, you can try following the commands in the docker file.

Building using the dockerfile

Note: This section is relevant only if you wish to build the Cairo python-package yourself, rather than downloading it.

The root directory holds a dedicated Dockerfile, which automatically builds the package and runs the unit tests on a simulated Ubuntu 18.04 environment. You should have docker installed (see https://docs.docker.com/get-docker/).

Clone the repository and initialize the git submodules using:

> git clone git@github.com:starkware-libs/cairo-lang.git
> cd cairo-lang

Build the docker image:

> docker build --tag cairo .

If everything works, you should see

Successfully tagged cairo:latest

Once the docker image is built, you can fetch the python package zip file using:

> container_id=$(docker create cairo)
> docker cp ${container_id}:/app/cairo-lang-0.13.4.zip .
> docker rm -v ${container_id}