Python Usage
============

This page is Option 1 in the full repository workflow.

It is the bridge page for the package / local CLI path.

If you want direct Python usage of the reusable package, use the companion repository:

* ``planktonclas``: https://github.com/woutdecrop/planktonclas

Use the package repository for:

* direct Python scripting examples
* loading trained models from Python
* prediction helpers used after training
* package-level automation and inference code

Use this repository instead for:

* Docker workflows
* AI4OS / OSCAR deployment
* notebook assets and project-level examples
* the broader phytoplankton workflow around the package

Typical Option 1 flow
---------------------

The usual path is:

1. install ``planktonclas``
2. create a project with ``planktonclas init``
3. validate the config
4. train a model
5. generate a report

For the detailed step-by-step explanation of that path, use:

* https://github.com/woutdecrop/planktonclas

What comes next
---------------

After Option 1, continue with:

* :doc:`reference` for project outputs and conventions
* :doc:`api_usage` if you want to switch to browser/API work
* :doc:`notebooks` if you want notebook-based exploration