The Algorand AlgoKit CLI is the one-stop shop tool for developers building on the Algorand network.
AlgoKit gets developers of all levels up and running with a familiar, fun and productive development environment in minutes. The goal of AlgoKit is to help developers build and launch secure, automated production-ready applications rapidly.
Install AlgoKit | Quick Start Tutorial | Documentation
AlgoKit compromises of a number of components that make it the one-stop shop tool for developers building on the Algorand network.
AlgoKit can help you learn, develop and operate Algorand solutions. It consists of a number of repositories, including this one.
There are many learning resources on the Algorand Developer Portal and the AlgoKit landing page has a range of links to more learning materials. In particular, check out the quick start tutorial and the AlgoKit detailed docs page.
If you need help you can access both the Algorand Discord (pro-tip: check out the algokit channel!) and the Algorand Forum.
We have also developed an AlgoKit video series.
AlgoKit helps you develop Algorand solutions:
- Interaction: AlgoKit exposes a number of interaction methods, namely:
- AlgoKit CLI: A Command Line Interface (CLI) so you can quickly access AlgoKit capabilities
- VS Code: All AlgoKit project templates include VS Code configurations so you have a smooth out-of-the-box development experience using VS Code
- Dappflow: AlgoKit has integrations with Dappflow; a web-based user interface that let's you visualise an Algorand network and deploy and call smart contracts via a graphical user interface
- Getting Started: AlgoKit helps you get started quickly when building new solutions:
- AlgoKit Templates: Template libraries to get you started faster and quickly set up a productive dev experience
- Development: AlgoKit provides SDKs, tools and libraries that help you quickly and effectively build high quality Algorand solutions:
- AlgoKit Utils (Python | TypeScript): A set of utility libraries so you can develop, test, build and deploy Algorand solutions quickly and easily
- algosdk (Python | TypeScript) - The core Algorand SDK providing Algorand protocol API calls, which AlgoKit Utils wraps, but still exposes for advanced scenarios
- Beaker: A productive Python framework for building Smart Contracts on Algorand.
- AlgoKit LocalNet: A local isolated Algorand network so you can simulate real transactions and workloads on your computer
- AlgoKit Utils (Python | TypeScript): A set of utility libraries so you can develop, test, build and deploy Algorand solutions quickly and easily
AlgoKit can help you deploy and operate Algorand solutions.
AlgoKit comes with out-of-the-box Continuous Integration / Continuous Deployment (CI/CD) templates that help you rapidly set up best-practice software delivery processes that ensure you build quality in and have a solution that can evolve
The set of capabilities supported by AlgoKit will evolve over time, but currently includes:
- Quickly run, explore and interact with an isolated local Algorand network (LocalNet)
- Building, testing, deploying and calling Algorand PyTEAL / Beaker smart contracts
For a user guide and guidance on how to use AlgoKit, please refer to the docs.
Future capabilities are likely to include:
- Quickly deploy standardised, audited smart contracts
- Building and deploying Algorand dApps
The target audience for this tool is software developers building applications on the Algorand network. A working knowledge of using a command line interfaces and experience using the supported programming languages is assumed.
This is an open source project managed by the Algorand Foundation. See the contributing page to learn about making improvements to the CLI tool itself, including developer setup instructions.
The key required dependency is Python 3.10+, but some of the installation options below will install that for you.
AlgoKit also has some runtime dependencies that also need to be available for particular commands.
Note You can still install and use AlgoKit without these dependencies and AlgoKit will tell you if you are missing one for a given command.
- Git - Git is used when creating and updating projects from templates
- Docker - Docker Compose (and by association, Docker) is used to run the AlgoKit LocalNet environment, we require Docker Compose 2.5.0+
AlgoKit can be installed using OS specific package managers, or using the python tool pipx see below for specific installation instructions.
Note This method will install the most recent python3 version via winget. If you already have python 3.10+ installed, you may prefer to use pipx directly instead so you can control the python version used.
-
Ensure prerequisites are installed
- Git (or
winget install git.git
) - Docker (or
winget install docker.dockerdesktop
)Note See our LocalNet documentation for more tips on installing Docker on Windows
- Git (or
-
Install using WinGet
-
Install python:
winget install python.python.3.11
-
Restart the terminal to ensure Python and pip are available on the path
Note Windows has a feature called App Execution Aliases that provides redirects for the Python command that guide users to the Windows Store. Unfortunately these aliases can prevent normal execution of Python if Python is installed via other means, to disable them search for Manage app execution aliases from the start menu, and then turn off entries listed as App Installer python.exe or App Installer python3.exe.
-
Install pipx:
pip install --user pipx python -m pipx ensurepath
-
Restart the terminal to ensure pipx is available on the path
-
Install AlgoKit via pipx:
pipx install algokit
-
Restart the terminal to ensure AlgoKit is available on the path
-
Some useful commands for updating or removing AlgoKit in the future.
- To update AlgoKit:
pipx upgrade algokit
- To remove AlgoKit:
pipx uninstall algokit
Note This method will install Python 3.10 as a dependency via Homebrew. If you already have python installed, you may prefer to use
pipx install algokit
as explained here.
-
Ensure prerequisites are installed
-
Install using Homebrew
brew install algorandfoundation/tap/algokit
-
Restart the terminal to ensure AlgoKit is available on the path
Some useful commands for updating or removing AlgoKit in the future.
- To update AlgoKit:
brew upgrade algokit
- To remove AlgoKit:
brew uninstall algokit
-
Ensure prerequisites are installed
-
Note There is probably a better way to install Python than to download it directly, e.g. your local Linux package manager
-
-
Continue with step 2 in the following section to install via pipx
-
Ensure desired prerequisites are installed
-
Install using pipx
pipx install algokit
-
Restart the terminal to ensure AlgoKit is available on the path
Some useful commands for updating or removing AlgoKit in the future.
- To update AlgoKit:
pipx upgrade algokit
- To remove AlgoKit:
pipx uninstall algokit
Verify AlgoKit is installed correctly by running algokit --version
and you should see output similar to:
algokit, version 1.0.1
Note If you get receive one of the following errors:
command not found: algokit
(bash/zsh)The term 'algokit' is not recognized as the name of a cmdlet, function, script file, or operable program.
(PowerShell)Then ensure that
algokit
is available on the PATH by runningpipx ensurepath
and restarting the terminal.
It is also recommended that you run algokit doctor
to verify there are no issues in your local environment and to diagnose any problems if you do have difficulties running AlgoKit. The output of this command will look similar to:
timestamp: 2023-03-27T01:23:45+00:00
AlgoKit: 1.0.1
AlgoKit Python: 3.11.1 (main, Dec 23 2022, 09:28:24) [Clang 14.0.0 (clang-1400.0.29.202)] (location: /Users/algokit/.local/pipx/venvs/algokit)
OS: macOS-13.1-arm64-arm-64bit
docker: 20.10.21
docker compose: 2.13.0
git: 2.37.1
python: 3.10.9 (location: /opt/homebrew/bin/python)
python3: 3.10.9 (location: /opt/homebrew/bin/python3)
pipx: 1.1.0
poetry: 1.3.2
node: 18.12.1
npm: 8.19.2
brew: 3.6.18
If you are experiencing a problem with AlgoKit, feel free to submit an issue via:
https://github.com/algorandfoundation/algokit-cli/issues/new
Please include this output, if you want to populate this message in your clipboard, run `algokit doctor -c`
Per the above output, the doctor command output is a helpful tool if you need to ask for support or raise an issue.