compario 2025.12.21102846

A new package that uses large language models and pattern matching to perform structured similarity comparisons between textual content based on normalized compression distance. Users provide multiple

Compario

Structured Text Similarity Comparison with Large Language Models

Compario is a Python package that leverages Normalized Compression Distance (NCD) and Large Language Models (LLMs) to perform structured similarity comparisons between textual content. It analyzes user-provided text snippets, computes similarity scores, and returns formatted results—ideal for automated content comparison without processing raw documents directly.

---

🔧 Installation

Install via pip:

pip install compario

---

🚀 Quick Start

Basic Usage

from compario import compario

# Example: Compare two text snippets
user_input = """
Text 1: "The quick brown fox jumps over the lazy dog."
Text 2: "A fast brown fox leaps across the sleepy canine."
"""
response = compario(user_input)
print(response)

Custom LLM Integration

By default, Compario uses ChatLLM7 (from langchain_llm7). You can override it with any LangChain-compatible LLM:

Using OpenAI

from langchain_openai import ChatOpenAI
from compario import compario

llm = ChatOpenAI()
response = compario(user_input, llm=llm)

Using Anthropic (Claude)

from langchain_anthropic import ChatAnthropic
from compario import compario

llm = ChatAnthropic()
response = compario(user_input, llm=llm)

Using Google Generative AI

from langchain_google_genai import ChatGoogleGenerativeAI
from compario import compario

llm = ChatGoogleGenerativeAI()
response = compario(user_input, llm=llm)

---

🔑 API Key & Rate Limits

• Default LLM (LLM7): Uses LLM7_API_KEY from environment variables or falls back to a default key.
• Free Tier: Sufficient for most use cases (check LLM7 docs for limits).
• Custom Key: Pass via api_key parameter or set LLM7_API_KEY in your environment:

  compario(user_input, api_key="your_api_key_here")
  

• Get a Free Key: Register at LLM7

---

📝 Parameters

Parameter	Type	Description
user_input	str	The text(s) to compare (e.g., multiple snippets separated by newlines).
api_key	Optional[str]	LLM7 API key (defaults to LLM7_API_KEY env var).
llm	Optional[BaseChatModel]	Custom LangChain LLM (e.g., ChatOpenAI, ChatAnthropic).

---

📌 Key Features

✅ Pattern Matching + NCD: Combines structured pattern analysis with compression-based similarity. ✅ Flexible LLM Support: Works with any LangChain-compatible model. ✅ No Raw Document Processing: Focuses on comparing extracted text snippets. ✅ Clear Output: Returns structured similarity results.

---

🐛 Issues & Support

For bugs or feature requests, open an issue on GitHub.

---

👤 Author

• Eugene Evstafev (@chigwell)
• Email: [e-mail]

---