Metadata-Version: 2.3
Name: oidm-common
Version: 0.2.2
Summary: Shared infrastructure for OIDM packages
Requires-Dist: duckdb>=1.0
Requires-Dist: pydantic>=2.0
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.0
Requires-Dist: loguru>=0.7
Requires-Dist: pooch>=1.8
Requires-Dist: asyncer==0.0.12
Requires-Dist: openai>=1.0 ; extra == 'openai'
Requires-Python: >=3.11
Provides-Extra: openai
Description-Content-Type: text/markdown

# oidm-common

Internal infrastructure package for the Open Imaging Data Model (OIDM) ecosystem.

## ⚠️ Not for Direct Use

This package provides shared infrastructure for OIDM packages. **Do not install this package directly.**

Instead, use one of the user-facing packages:
- [`findingmodel`](https://pypi.org/project/findingmodel/) - Finding model index and search
- [`anatomic-locations`](https://pypi.org/project/anatomic-locations/) - Anatomic location ontology
- [`findingmodel-ai`](https://pypi.org/project/findingmodel-ai/) - AI-powered finding model tools

## Contents

- DuckDB connection management and hybrid search
- Embedding cache and providers
- Distribution utilities (manifest, download, paths)
- Shared data models (IndexCode, WebReference)

## Embedding cache

High-level helpers (`get_embedding`, `get_embeddings_batch`) use a DuckDB-backed cache by default at
`~/.cache/findingmodel/embeddings.duckdb`. Pass `cache=None` to disable caching, or pass an
`EmbeddingCache` instance to override the path.
