Metadata-Version: 2.4
Name: poma
Version: 0.3.4
Summary: Official Python SDK for the Poma document-processing API
Author-email: "POMA AI GmbH, Berlin" <sdk@poma-ai.com>
License-Expression: MPL-2.0
Keywords: chunking,structure,rag,poma,documents,ai
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx==0.28.1
Requires-Dist: pydantic==2.11.7
Provides-Extra: langchain
Requires-Dist: langchain==0.3.27; extra == "langchain"
Requires-Dist: langchain-text-splitters==0.3.9; extra == "langchain"
Provides-Extra: llamaindex
Requires-Dist: llama-index==0.13.0; extra == "llamaindex"
Provides-Extra: qdrant
Requires-Dist: qdrant-client[fastembed]==1.16.2; extra == "qdrant"
Provides-Extra: all
Requires-Dist: langchain==0.3.27; extra == "all"
Requires-Dist: langchain-text-splitters==0.3.9; extra == "all"
Requires-Dist: llama-index==0.13.0; extra == "all"
Requires-Dist: llama-index-vector-stores-faiss==0.5.0; extra == "all"
Requires-Dist: faiss-cpu==1.10.0; extra == "all"
Requires-Dist: langchain_openai==0.3.28; extra == "all"
Requires-Dist: langchain_community==0.3.27; extra == "all"
Requires-Dist: llama-index-embeddings-langchain==0.4.0; extra == "all"
Requires-Dist: qdrant-client[fastembed]==1.16.2; extra == "all"
Requires-Dist: dotenv; extra == "all"
Dynamic: license-file

![POMA AI Logo](https://raw.githubusercontent.com/poma-ai/.github/main/assets/POMA_AI_Logo_Pink.svg)
# 📚 POMA: Preserving Optimal Markdown Architecture

## 🚀Quick-Start Guide

### Installation

Requires Python 3.10+. Install the core packages:
```bash
pip install poma
```

For different integrations:
```bash
pip install 'poma[langchain]'
pip install 'poma[llamaindex]'
pip install 'poma[qdrant]'

# Or LangChain/LlamaIndex/Qdrant including example extras:
pip install 'poma[all]'
```


- You may also want: `pip install python-dotenv` to load API keys from a .env file.
- API keys required (POMA_API_KEY) for the POMA AI client via environment variables.
- **To request a POMA_API_KEY, please contact us at sdk@poma-ai.com**


### Example Implementations — all examples, integrations, and additional information can be found in our GitHub repository: [poma-ai/poma](https://github.com/poma-ai/)

We provide example implementations to help you get started with POMA AI:
- example.py — A standalone implementation for documents, showing the basic POMA AI workflow with simple keyword-based retrieval
- example_langchain.py — Integration with LangChain, demonstrating how easy it is to use POMA AI with LangChain
- example_llamaindex.py — Integration with LlamaIndex, showing how simple it is to use POMA AI with LlamaIndex
-

*Note: The integration examples use OpenAI embeddings. Make sure to set your OPENAI_API_KEY environment variable, or replace the embeddings with your preferred ones.*


All examples follow the same two-phase process (ingest → retrieve) but demonstrate different integration options for your RAG pipeline.

! Please do NOT send any sensitive and/or personal information to POMA AI endpoints without having a signed contract & DPA !
