Metadata-Version: 2.4
Name: catalogmesh
Version: 3.3.2
Summary: CatalogMesh multilingual AI workspace for product catalog operations, review, storage and guarded automation
Author: Mohamed Anwar
License: MIT License
        
        Copyright (c) 2026 AI Product Photo Sorter contributors
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/mhmdwaelanwr/CatalogMesh
Project-URL: Repository, https://github.com/mhmdwaelanwr/CatalogMesh
Project-URL: Issues, https://github.com/mhmdwaelanwr/CatalogMesh/issues
Project-URL: Changelog, https://github.com/mhmdwaelanwr/CatalogMesh/blob/main/CHANGELOG.md
Keywords: ai,computer-vision,product-photography,photo-organizer,image-classification,product-catalog,catalog-operations,gemini,openai,anthropic,multi-provider,tkinter,desktop-app,cli,api-key-rotation,rclone,cloud-storage,open-source,mcp,automation
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow<13,>=10
Requires-Dist: google-genai<3,>=2.21.0
Requires-Dist: openpyxl<4,>=3.1
Requires-Dist: keyring<27,>=25
Requires-Dist: arabic-reshaper<4,>=3
Requires-Dist: python-bidi<1,>=0.6
Provides-Extra: local-embeddings
Requires-Dist: fastembed<1,>=0.5; extra == "local-embeddings"
Provides-Extra: local-evidence
Requires-Dist: numpy<3,>=1.26; extra == "local-evidence"
Requires-Dist: rapidocr<4,>=3.9; extra == "local-evidence"
Requires-Dist: onnxruntime<2,>=1.27; extra == "local-evidence"
Requires-Dist: zxing-cpp<4,>=3.1; extra == "local-evidence"
Provides-Extra: mcp
Requires-Dist: mcp<3,>=2; extra == "mcp"
Dynamic: license-file

# CatalogMesh

**CatalogMesh** is a cross-platform AI workspace for product catalog operations: product-photo grouping, human review, SKU matching, exports, storage and guarded catalog automation.

## Install

Requires Python 3.10 or newer.

```bash
python -m pip install --upgrade catalogmesh
```

Launch the desktop GUI:

```bash
catalogmesh-gui
```

Or use the main CLI:

```bash
catalogmesh --help
```

Optional runtimes:

```bash
python -m pip install "catalogmesh[local-embeddings]"
python -m pip install "catalogmesh[local-evidence]"
python -m pip install "catalogmesh[mcp]"
```

## What CatalogMesh includes

- Cloud vision providers: Gemini, OpenAI and Anthropic.
- Ollama local vision and local-first/cloud-fallback workflows.
- Crash-safe resumable product-photo grouping.
- Non-destructive Review Center with human approval state.
- Deterministic SKU/catalog candidate matching with mandatory human confirmation.
- Safe offline Shopify/PIM exports.
- Approval-aware Shopify, Akeneo and Odoo connector workflows.
- Local-first rclone Storage Center.
- Reports, benchmarks, environment management and automation tools.
- English, Arabic and Chinese desktop localization.

## Safety model

CatalogMesh never treats an AI guess as confirmed catalog identity. SKU confirmation remains human-controlled. Publication and remote connector mutations keep explicit approval/reservation boundaries, and MCP does not expose autonomous publication or generic remote mutation.

## Compatibility

`catalogmesh` is the primary PyPI project name.

The historical package name `ai-product-photo-sorter`, legacy `product-sorter-*` command aliases and `PRODUCT_SORTER_*` settings were used by earlier v3.x releases. The command aliases and persisted configuration identifiers remain supported so existing local workflows are not unnecessarily broken.

## Desktop builds

Ready-to-run Windows, Linux and macOS artifacts are published on the GitHub Releases page for the project repository.

Repository: https://github.com/mhmdwaelanwr/CatalogMesh
