Get Started

FireDucks is released on pypi.org under the 3-Clause BSD License (the Modified BSD License).

Install

FireDucks is currently available for Linux (manylinux) on the x86_64 architecture and it can be simply installed using pip as follows:

pip install fireducks

Please make sure you are using Python >=3.8, <=3.12, otherwise you may encounter error saying: “No matching distribution found for fireducks”.

Windows and MacOS versions are under development. We will soon be releasing the beta-version of FireDucks for these platforms. At this moment, if you are working on Windows system, you may like to consider using FireDucks from WSL (Windows Subsystem for Linux).

Usage

FireDucks provides two types of usage: Import Hook and Explicit Import.

Import Hook

FireDucks provides an import hook utility. This utility runs the given Python script by automatically replacing import pandas statement with FireDucks. So this utility enables you to use FireDucks for your existing program as it is. The import hook can be activated by Python interpreter’s -m option as follows.

python3 -m fireducks.pandas your_script.py

For IPython/Jupyter Notebook, a magic command is available as follows.

%load_ext fireducks.pandas
import pandas as pd

This is very useful when your program includes many Python scripts which import pandas internally. You don’t need to replace individual import statements from those scripts manually.

If you use any external libraries (like matplotlib etc.) which may internally use pandas DataFrame, please make sure to enable the hook to avoid any unintended executional issues.

📢 The import hook feature has changed its name to fireducks.pandas from FireDucks 0.11.0. An old module name fireducks.imhook is also available as an alias.

Explicit Import

FireDucks has pandas-like module fireducks.pandas which can be imported instead of pandas. If you want to use FireDucks for an existing pandas program, replace the import statement as follows.

# import pandas as pd
import fireducks.pandas as pd