PHPackages                             biigle/maia - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. biigle/maia

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

biigle/maia
===========

BIIGLE module module for the Machine Learning Assisted Image Annotation method.

v2.11.2(3mo ago)29.0k3[43 issues](https://github.com/biigle/maia/issues)GPL-3.0-onlyPHPCI passing

Since Nov 20Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/biigle/maia)[ Packagist](https://packagist.org/packages/biigle/maia)[ Docs](https://biigle.de)[ RSS](/packages/biigle-maia/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (126)Used By (0)

BIIGLE MAIA Module
==================

[](#biigle-maia-module)

[![Test status](https://github.com/biigle/maia/workflows/Tests/badge.svg)](https://github.com/biigle/maia/actions?query=workflow%3ATests)

This is the BIIGLE module module for the [Machine Learning Assisted Image Annotation](https://doi.org/10.1371/journal.pone.0207498) method.

Installation
------------

[](#installation)

1. Run `composer require biigle/maia`.
2. Install the Python dependencies with `pip install -r requirements.txt`.
3. Add `Biigle\Modules\Maia\MaiaServiceProvider::class` to the `providers` array in `config/app.php`.
4. Run `php artisan vendor:publish --tag=public` to publish the public assets of this module.
5. Run `docker-compose exec app php artisan migrate` to create the new database tables.
6. Configure a storage disk each for the training proposal and annotation candidate patches. Set the `MAIA_TRAINING_PROPOSAL_STORAGE_DISK` and `MAIA_ANNOTATION_CANDIDATE_STORAGE_DISK` variables in the `.env` file to the name of the respective storage disk. Do not use the same disk for both! The content of the storage disks should be publicly accessible. Example for local disks: ```
    // MAIA_TRAINING_PROPOSAL_STORAGE_DISK
    'maia-tp' => [
        'driver' => 'local',
        'root' => storage_path('app/public/maia-tp-patches'),
        'url' => env('APP_URL').'/storage/maia-tp-patches',
        'visibility' => 'public',
    ],
    // MAIA_ANNOTATION_CANDIDATE_STORAGE_DISK
    'maia-ac' => [
        'driver' => 'local',
        'root' => storage_path('app/public/maia-ac-patches'),
        'url' => env('APP_URL').'/storage/maia-ac-patches',
        'visibility' => 'public',
    ],
    ```

    This requires the link `storage -> ../storage/app/public` in the `public` directory.

Configuration
-------------

[](#configuration)

New processing jobs are submitted to the `default` queue of the `gpu` connection. You can configure these with the `MAIA_JOB_QUEUE` and `MAIA_JOB_CONNECTION` environment variables. Optionally, you can configure a different queue (but not connection) fot the jobs to generate feature vectors with `MAIA_FEATURE_VECTOR_QUEUE`. This can be used to give jobs to generate feature vectors a higher priority.

References
----------

[](#references)

Reference publications that you should cite if you use MAIA for one of your studies.

- **BIIGLE 2.0**[Langenkämper, D., Zurowietz, M., Schoening, T., &amp; Nattkemper, T. W. (2017). Biigle 2.0-browsing and annotating large marine image collections.](https://doi.org/10.3389/fmars.2017.00083)Frontiers in Marine Science, 4, 83. doi: `10.3389/fmars.2017.00083`
- **MAIA**[Zurowietz, M., Langenkämper, D., Hosking, B., Ruhl, H. A., &amp; Nattkemper, T. W. (2018). MAIA—A machine learning assisted image annotation method for environmental monitoring and exploration.](https://doi.org/10.1371/journal.pone.0207498)PloS one, 13(11), e0207498. doi: `10.1371/journal.pone.0207498`

Developing
----------

[](#developing)

Take a look at the [development guide](https://github.com/biigle/core/blob/master/DEVELOPING.md) of the core repository to get started with the development setup.

Want to develop a new module? Head over to the [biigle/module](https://github.com/biigle/module) template repository.

Contributions and bug reports
-----------------------------

[](#contributions-and-bug-reports)

Contributions to BIIGLE are always welcome. Check out the [contribution guide](https://github.com/biigle/core/blob/master/CONTRIBUTING.md) to get started.

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance66

Regular maintenance activity

Popularity28

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Total

119

Last Release

97d ago

Major Versions

v0.1.0 → v1.0.02018-12-20

v1.24.0 → v2.0.0-beta2023-01-31

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2457311?v=4)[Martin Zurowietz](/maintainers/mzur)[@mzur](https://github.com/mzur)

---

Top Contributors

[![mzur](https://avatars.githubusercontent.com/u/2457311?v=4)](https://github.com/mzur "mzur (669 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (31 commits)")[![lehecht](https://avatars.githubusercontent.com/u/72259845?v=4)](https://github.com/lehecht "lehecht (9 commits)")

---

Tags

biiglebiigle-modulebiiglebiigle-module

### Embed Badge

![Health badge](/badges/biigle-maia/health.svg)

```
[![Health](https://phpackages.com/badges/biigle-maia/health.svg)](https://phpackages.com/packages/biigle-maia)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
