Installation

To install the CLI, we recommend using uv. Note that the CLI requires Python 3.9 or greater.

If you don't already have uv, follow the installation instructions. Then install the CLI as a tool:

uv tool install aqora

This makes the aqora command available globally. To upgrade later, run:

uv tool upgrade aqora

Notes for Windows users

If uv gives you a warning that the script is not on your PATH, you can copy the directory in the warning and add it to your path by following the instructions here

You may also need to install the latest Visual C++ Redistributable Version. You can find the latest version here

Getting Started

To verify the installation, the following should output helpful information

aqora help

Once the CLI has installed you can login to your account with the following command

aqora login

Browse the competitions on aqora.io and climb the leaderboards!

Contributing

We strongly recommend you to install a stable Rust toolchain using Rustup, and a stable Python runtime through official distributions.

Our main branch is called main. Please open a pull-request up-to-date to that branch when you request our feedback.

Please follow Conventional Commits, which allows our project to have beautiful changelogs based on your commit messages. We strongly encourage you to install Cocogitto:

$ cargo install cocogitto cargo-edit
$ cog install-hook --all