Installation

Use this page when setting up flopscope for the first time.

You will learn:

How to install flopscope as a dependency or for development
How to verify your installation works
How to fix common installation pitfalls

Install as a dependency

uv add git+https://github.com/AIcrowd/flopscope.git

Install for development

git clone https://github.com/AIcrowd/flopscope.git
cd flopscope
uv sync --all-extras

Verify installation

uv run python -c "import flopscope as flops; print(flops.__version__)"

What you'll see

0.2.0+np2.2.6

The version string includes the installed NumPy version suffix. If you see a version number, flopscope is installed correctly.

Common pitfalls

Symptom: ImportError: numpy version mismatch

Fix: Flopscope supports NumPy >=2.0.0,<2.3.0 (default install uses NumPy 2.2). Using uv handles this automatically. If you installed manually, check your NumPy version:

uv run python -c "import numpy; print(numpy.__version__)"

Quickstart — run your first FLOP-counted computation