Skip to main content

VPSCompass

PyPI version License: MIT Downloads LinkedIn

VPSCompass is a lightweight Python package that lets you quickly compare virtual private server (VPS) offerings from raw text inputs.
Just paste a list of providers, plans, or key feature snippets and get a structured breakdown of pricing, performance, and trade‑offs in a single function call.


Installation

pip install vpscompass

Usage

# Basic usage with the default LLM7 model
from vpscompass import vpscompass

user_input = """
Provider A: 1 vCPU, 2GB RAM, 50GB SSD, $10/month, 1TB bandwidth
Provider B: 2 vCPU, 4GB RAM, 100GB SSD, $20/month, 2TB bandwidth
"""

comparison = vpscompass(user_input)
print(comparison)
[
  "Provider A | 1 vCPU | 2GB RAM | 50GB SSD | $10 | 1TB bandwidth",
  "Provider B | 2 vCPU | 4GB RAM | 100GB SSD | $20 | 2TB bandwidth"
]

Parameters

  • user_input: str
    The raw text that contains provider details.
  • llm: Optional[BaseChatModel]
    Optional LangChain LLM instance. If omitted, the package falls back to ChatLLM7 from langchain_llm7.
  • api_key: Optional[str]
    API key for LLM7. If not supplied, the package looks for the LLM7_API_KEY environment variable, and finally defaults to "None" when no key is available.

Swapping the Default LLM

You can provide any LangChain compatible model. Below are a few examples:

OpenAI

from langchain_openai import ChatOpenAI
from vpscompass import vpscompass

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

Anthropic

from langchain_anthropic import ChatAnthropic
from vpscompass import vpscompass

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

Google Generative AI

from langchain_google_genai import ChatGoogleGenerativeAI
from vpscompass import vpscompass

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

Rate Limits & API Keys

The default free tier of LLM7 comes with generous rate limits suitable for most use cases.
If you need higher limits, just supply your own key:

export LLM7_API_KEY="YOUR_KEY"

or pass it directly:

vpscompass(user_input, api_key="YOUR_KEY")

You can obtain a free key by registering at https://token.llm7.io/.


Issues & Contributions

Have a bug or feature request? Open an issue on the GitHub repository.

GitHub issues: https://github.com/chigwell/vpscompass/


Author


Metadata

Release files for vpscompass 2025.12.21171110

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

Source distribution (sdist)

Source distribution for vpscompass 2025.12.21171110
File Size Uploaded
vpscompass-2025.12.21171110.tar.gz 5.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vpscompass 2025.12.21171110
File Interpreter ABI Platform
vpscompass-2025.12.21171110-py3-none-any.whl Python 3 none any Details

Total release size: 11.5 kB

Release files / vpscompass-2025.12.21171110.tar.gz

Download URL vpscompass-2025.12.21171110.tar.gz
Size 5.5 kB
Tags Source
SHA-256 checksum
How to use checksums
62609578f188f09da741e0118e620e7e534e01214ef6d0fdbe8378eda36cac05
BLAKE2b-256 checksum
How to use checksums
84436d6e704e1eaa4be177c792b980035b9c288653d3309ac7d99c3c1a282c33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release files / vpscompass-2025.12.21171110-py3-none-any.whl

Download URL vpscompass-2025.12.21171110-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
201c8fb274de4b54971ed93e14eae29b1440245ab18d068e284865c275443e0f
BLAKE2b-256 checksum
How to use checksums
f0e0895c58ec5ff30d87eda417ca9ee07e6b1bbf1c845ca03079e1dea4720fdc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release history Release notifications | RSS feed

This release

2025.12.21171110 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page