AI-Parrot Pipelines

ai-parrot-pipelines provides planogram compliance and vision workflows for AI-Parrot agents.

Installation

pip install ai-parrot-pipelines

Install the optional local-OCR dependencies when needed:

pip install "ai-parrot-pipelines[planogram]"

Features

Planogram Compliance — a perceive → identify → compare cycle for six types
Layout Profiles — validated, per-type geometry and identification settings
Optional Local OCR — RapidOCR is auto-detected when the planogram extra is installed
Migration Utility — converts and preflights six planogram configuration types

Available Pipelines

Pipeline/type	Description
`PlanogramCompliance`	Planogram compliance pipeline
`ProductOnShelves`	Product-facing shelves
`InkWall`	Price-tag-anchored ink walls
`EndcapBacklitMultitier`	Multi-tier endcaps
`EndcapNoShelvesPromotional`	Zone-based promotional endcaps
`GraphicPanelDisplay`	Zone-only graphic panels
`ProductCounter`	Product and zone counters

Quick Start

from parrot_pipelines.planogram.plan import PlanogramCompliance
from parrot_pipelines.models import PlanogramConfig

config = PlanogramConfig(
    config_name="example",
    planogram_type="product_on_shelves",
    planogram_config={},
    slots_definition={
        "version": "1",
        "shelves": [
            {
                "shelf_id": "shelf_1",
                "shelf_number": 1,
                "facings": [
                    {
                        "facing_id": "facing_1",
                        "shelf_id": "shelf_1",
                        "slot": 1,
                        "product": "example_product",
                        "descriptors": {"display_name": "Example product"},
                    }
                ],
            }
        ],
        "zones": [],
    },
)

pipeline = PlanogramCompliance(planogram_config=config, llm="openai:gpt-4o-mini")
result = await pipeline.run("shelf_photo.jpg")

Provide a complete, validated slots definition and rule bindings before a production run. See the cycle reference and the migration runbook.

Dependencies

Python >= 3.11
ai-parrot >= 0.24.2
opencv-python-headless >= 4.8
Optional planogram extra: rapidocr and onnxruntime

1.1.0 breaking changes

The removed detector APIs and required configuration migration are documented in the migration runbook.

License

MIT

Metadata

Release files for ai-parrot-pipelines 1.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-parrot-pipelines 1.3.3
File	Size	Uploaded
ai_parrot_pipelines-1.3.3.tar.gz	143.3 kB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ai-parrot-pipelines 1.3.3
File	Interpreter	ABI	Platform	Reset
ai_parrot_pipelines-1.3.3-py3-none-any.whl 174.8 kB Oct 16, 2026	Python 3	none	any	Details

Total release size: 318.1 kB

Release files / ai_parrot_pipelines-1.3.3.tar.gz

Download URL	ai_parrot_pipelines-1.3.3.tar.gz
Size	143.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`e8d5ca33c3aae9c1411a45310ac47cc9412eb551fd9ec571dd678a7ca3eb8fb4`
BLAKE2b-256 checksum How to use checksums	`0dce58d0a7acd4f808b5843547c10d4e6628f2e5ca51babd15d41a64df8bdf1f`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/phenobarbital/ai-parrot
Publishing commit: github.com/phenobarbital/ai-parrot/tree/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1

Workflow

Publishing configuration: github.com/phenobarbital/ai-parrot/blob/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1/.github/workflows/release.yml
Publishing logs: github.com/phenobarbital/ai-parrot/actions/runs/38831313265/attempts/1

Artifact

Subject: ai_parrot_pipelines-1.3.3.tar.gz
SHA-256 checksum: e8d5ca33c3aae9c1411a45310ac47cc9412eb551fd9ec571dd678a7ca3eb8fb4 Verifying attestations

Release files / ai_parrot_pipelines-1.3.3-py3-none-any.whl

Download URL	ai_parrot_pipelines-1.3.3-py3-none-any.whl
Size	174.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`99f234ea2b5f9aa6a14842f48059ddba9e594e3c4cb1e2e55a4df4cc03bad610`
BLAKE2b-256 checksum How to use checksums	`cd615bca4255b68d0dbf4e5e39dd2909a042034911a4c12acd9cc031af169b10`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/phenobarbital/ai-parrot
Publishing commit: github.com/phenobarbital/ai-parrot/tree/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1

Workflow

Publishing configuration: github.com/phenobarbital/ai-parrot/blob/22b0c4ed75a07105a3a8c12d09dbb056ba94c9b1/.github/workflows/release.yml
Publishing logs: github.com/phenobarbital/ai-parrot/actions/runs/38831313265/attempts/1

Artifact

Subject: ai_parrot_pipelines-1.3.3-py3-none-any.whl
SHA-256 checksum: 99f234ea2b5f9aa6a14842f48059ddba9e594e3c4cb1e2e55a4df4cc03bad610 Verifying attestations