lm-deluge 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

lm_deluge/prompt.py

@@ -36,6 +36,9 @@ class Text:
     def gemini(self) -> dict:
         return {"text": self.text}
 
+    def mistral(self) -> dict:
+        return {"type": "text", "text": self.text}
+
 
 ###############################################################################
 # 2. One conversational turn (role + parts)                                   #
@@ -162,6 +165,12 @@ class Message:
         role = "user" if self.role == "user" else "model"
         return {"role": role, "parts": parts}
 
+    def mistral(self) -> dict:
+        parts = [p.mistral() for p in self.parts]
+        # Shortcut: single text becomes a bare string
+        role = self.role
+        return {"role": role, "content": parts}
+
 
 ###############################################################################
 # 3. A whole conversation (ordered list of messages)                          #
@@ -233,15 +242,8 @@ class Conversation:
         other = [m.gemini() for m in self.messages if m.role != "system"]
         return system_msg, other
 
-    def to_cohere(self) -> list[dict]:
-        messages = []
-        for m in self.messages:
-            if len(m.parts) > 1:
-                raise ValueError("Cohere does not support multi-part messages")
-            if isinstance(m.parts[0], Image):
-                raise ValueError("Cohere does not support images")
-            messages.append({"role": m.role, "text": m.parts[0].text})
-        return messages
+    def to_mistral(self) -> list[dict]:
+        return [m.mistral() for m in self.messages]
 
     # ── misc helpers ----------------------------------------------------------
     _tok = tiktoken.encoding_for_model("gpt-4")

lm_deluge/util/json.py

@@ -31,8 +31,8 @@ def strip_json(json_string: str | None) -> str | None:
     if json_string is None:
         return None
     json_string = json_string.strip()
-    if json_string.startswith("```json"):
-        json_string = json_string.split("```json", 1)[1]
+    json_string = json_string.removeprefix("```json")
+    json_string = json_string.removesuffix("```")
     if "```json\n" in json_string:
         json_string = json_string.split("```json\n", 1)[1]
     json_string = json_string.strip("`").strip()
@@ -127,7 +127,8 @@ def load_json(
     if json_string is None:
         raise ValueError("Invalid (None) json_string")
     json_string = strip_json(json_string)
-    raise ValueError("Invalid (empty) json_string")
+    if json_string is None or len(json_string) == 0:
+        raise ValueError("Invalid (empty) json_string")
 
     # Try standard JSON parsing
     try:

lm_deluge/util/xml.py

@@ -66,26 +66,25 @@ def get_tags(html_string: str, tag: str, return_attributes: bool = False) -> lis
         return []
 
     try:
-        # Regex pattern to match all instances of the tag and capture attributes and content
+        # 1. find the tag + inner HTML exactly as before
         pattern = re.compile(rf"<{tag}([^>]*)>(.*?)</{tag}>", re.DOTALL)
         matches = pattern.findall(html_string)
 
+        # 2. only parse attributes if the caller asked for them
         if not return_attributes:
-            return [
-                match[1] for match in matches
-            ]  # Return just the content inside the tags
+            return [m[1] for m in matches]
 
-        # Parse attributes if return_attributes is True
-        attributes_pattern = re.compile(r'(\w+)\s*=\s*"([^"]*)"')  # Matches key="value"
+        # --- new bits ---------------------------------------------------------------
+        # key  = (\w+)
+        # quote = (['"])          ← remembers whether it was ' or "
+        # value = (.*?)\2         ← capture up to the *same* quote (back-ref \2)
+        attributes_pattern = re.compile(r'(\w+)\s*=\s*([\'"])(.*?)\2')
 
         results = []
-        for match in matches:
-            tag_attributes = match[0]  # The attributes portion of the tag
-            tag_contents = match[1]  # The content portion of the tag
+        for tag_attrs, tag_contents in matches:
+            attrs = {key: val for key, _, val in attributes_pattern.findall(tag_attrs)}
+            results.append({"content": tag_contents, "attributes": attrs})
 
-            # Parse attributes into a dictionary
-            attributes = dict(attributes_pattern.findall(tag_attributes))
-            results.append({"content": tag_contents, "attributes": attributes})
         return results
     except re.error:
         print(f"Failed to compile regular expression for HTML tag '{tag}'")

lm_deluge-0.0.6.dist-info/METADATA

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: lm_deluge
+Version: 0.0.6
+Summary: Python utility for using LLM API models.
+Author-email: Benjamin Anderson <ben@trytaylor.ai>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+Requires-Dist: json5
+Requires-Dist: PyYAML
+Requires-Dist: pandas
+Requires-Dist: aiohttp
+Requires-Dist: tiktoken
+Requires-Dist: xxhash
+Requires-Dist: tqdm
+Requires-Dist: google-auth
+Requires-Dist: requests-aws4auth
+Requires-Dist: pydantic
+Requires-Dist: bs4
+Requires-Dist: lxml
+Requires-Dist: pdf2image
+Requires-Dist: pillow
+Provides-Extra: full
+Requires-Dist: pymupdf; extra == "full"
+Requires-Dist: fasttext-wheel; extra == "full"
+Requires-Dist: fasttext-langdetect; extra == "full"
+
+# lm_deluge
+
+`lm_deluge` is a lightweight helper library for maxing out your rate limits with LLM providers. It provides the following:
+
+- **Unified client** – Send prompts to all relevant models with a single client.
+- **Massive concurrency with throttling** – Set `max_tokens_per_minute` and `max_requests_per_minute` and let it fly. The client will process as many requests as possible while respecting rate limits and retrying failures.
+- **Spray across models/providers** – Configure a client with multiple models from any provider(s), and sampling weights. The client samples a model for each request.
+- **Caching** – Save completions in a local or distributed cache to avoid repeated LLM calls to process the same input.
+- **Convenient message constructor** – No more looking up how to build an Anthropic messages list with images. Our `Conversation` and `Message` classes work great with our client or with the `openai` and `anthropic` packages.
+- **Sync and async APIs** – Use the client from sync or async code.
+
+**STREAMING IS NOT IN SCOPE.** There are plenty of packages that let you stream chat completions across providers. The sole purpose of this package is to do very fast batch inference using APIs. Sorry!
+
+## Installation
+
+```bash
+pip install lm-deluge
+```
+
+There are optional goodies. If you want support for PDFs and language-detection via FastText:
+```bash
+pip install "lm-deluge[full]"
+```
+
+The package relies on environment variables for API keys. Typical variables include `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `COHERE_API_KEY`, `META_API_KEY`, and `GOOGLE_API_KEY`. `LLMClient` will automatically load the `.env` file when imported; we recommend using that to set the environment variables.
+
+## Quickstart
+
+The easiest way to get started is with the `.basic` constructor. This uses sensible default arguments for rate limits and sampling parameters so that you don't have to provide a ton of arguments.
+
+```python
+from lm_deluge import LLMClient
+
+client = LLMClient.basic("gpt-4o-mini")
+resps = client.process_prompts_sync(["Hello, world!"])
+print(resp[0].completion)
+```
+
+## Spraying Across Models
+
+To distribute your requests across models, just provide a list of more than one model to the constructor. The rate limits for the client apply to the client as a whole, not per-model, so you may want to increase them:
+
+```python
+from lm_deluge import LLMClient
+
+client = LLMClient.basic(
+    ["gpt-4o-mini", "claude-haiku-anthropic"],
+    max_requests_per_minute=10_000
+)
+resps = client.process_prompts_sync(
+    ["Hello, ChatGPT!", "Hello, Claude!"]
+)
+print(resp[0].completion)
+```
+
+## Configuration
+
+API calls can be customized in a few ways.
+
+1. **Sampling Parameters.** This determines things like structured outputs, maximum completion tokens, nucleus sampling, etc. Provide a custom `SamplingParams` to the `LLMClient` to set temperature, top_p, json_mode, max_new_tokens, and/or reasoning_effort.
+
+You can pass 1 `SamplingParams` to use for all models, or a list of `SamplingParams` that's the same length as the list of models. You can also pass many of these arguments directly to `LLMClient.basic` so you don't have to construct an entire `SamplingParams` object.
+
+
+2. **Arguments to LLMClient.** This is where you set request timeout, rate limits, model name(s), model weight(s) for distributing requests across models, retries, and caching.
+3. **Arguments to process_prompts.** Per-call, you can set verbosity, whether to display progress, and whether to return just completions (rather than the full APIResponse object).
+
+Putting it all together:
+
+```python
+from lm_deluge import LLMClient, SamplingParams
+
+client = LLMClient(
+    "gpt-4",
+    max_requests_per_minute=100,
+    max_tokens_per_minute=100_000,
+    max_concurrent_requests=500,
+    sampling_params=SamplingParams(temperature=0.5, max_new_tokens=30)
+)
+
+await client.process_prompts_async(
+    ["What is the capital of Mars?"],
+    show_progress=False,
+    return_completions_only=True
+)
+```
+
+## Multi-Turn Conversations
+
+Constructing conversations to pass to models is notoriously annoying. Each provider has a slightly different way of defining a list of messages, and with the introduction of images/multi-part messages it's only gotten worse. We provide convenience constructors so you don't have to remember all that stuff.
+
+```python
+from lm_deluge import Message, Conversation
+
+prompt = Conversation.system("You are a helpful assistant.").add(
+    Message.user("What's in this image?").add_image("tests/image.jpg")
+)
+
+client = LLMClient.basic("gpt-4.1-mini")
+resps = client.process_prompts_sync([prompt])
+```
+
+This just works. Images can be local images on disk, URLs, bytes, base64 data URLs... go wild. You can use `Conversation.to_openai` or `Conversation.to_anthropic` to format your messages for the OpenAI or Anthropic clients directly.
+
+## Caching
+
+`lm_deluge.cache` includes LevelDB, SQLite and custom dictionary based caches.  Pass an instance via `LLMClient(..., cache=my_cache)` and previously seen prompts will not be re‑sent across different `process_prompts_[...]` calls.
+
+**IMPORTANT:** Caching does not currently work for prompts in the SAME batch. That is, if you call `process_prompts_sync` with the same prompt 100 times, there will be 0 cache hits. If you call `process_prompts_sync` a *second* time with those same 100 prompts, all 100 will be cache hits. The cache is intended to be persistent and help you save costs across many invocations, but it can't help with a single batch-inference session (yet!).
+
+## Asynchronous Client
+Use this in asynchronous code, or in a Jupyter notebook. If you try to use the sync client in a Jupyter notebook, you'll have to use `nest-asyncio`, because internally the sync client uses async code. Don't do it! Just use the async client!
+
+```python
+import asyncio
+
+async def main():
+    responses = await client.process_prompts_async(
+        ["an async call"],
+        return_completions_only=True,
+    )
+    print(responses[0])
+
+asyncio.run(main())
+```
+
+## Available Models
+
+We support all models in `src/lm_deluge/models.py`. An older version of this client supported Bedrock and Vertex. We plan to re-implement Bedrock support (our previous support was spotty and we need to figure out cross-region inference in order to support the newest Claude models). Vertex support is not currently planned, since Google allows you to connect your Vertex account to AI Studio, and Vertex authentication is a huge pain (requires service account credentials, etc.)
+
+## Feature Support
+
+We support structured outputs via `json_mode` parameter provided to `SamplingParams`. Structured outputs with a schema are planned. Reasoning models are supported via the `reasoning_effort` parameter, which is translated to a thinking budget for Claude/Gemini. Image models are supported. We don't support tool use yet, but support is planned (keep an eye out for a unified tool definition spec that works for all models!). We support logprobs for OpenAI models that return them via the `logprobs` argument to the `LLMClient`.
+
+## Built‑in tools
+
+The `lm_deluge.llm_tools` package exposes a few helper functions:
+
+- `extract` – structure text or images into a Pydantic model based on a schema.
+- `translate` – translate a list of strings to English.
+- `score_llm` – simple yes/no style scoring with optional log probability output.
+
+Experimental embeddings (`embed.embed_parallel_async`) and document reranking (`rerank.rerank_parallel_async`) clients are also provided.

{lm_deluge-0.0.4.dist-info → lm_deluge-0.0.6.dist-info}/RECORD

@@ -1,37 +1,37 @@
-lm_deluge/__init__.py,sha256=r3Erra7aT5i2Mu5B9lcY8ll1T6q8_xF-xgnataKgKPg,153
+lm_deluge/__init__.py,sha256=rndOr4Rcfnpttz-onWU3vVEm-MM0WDFgz6KexKPAx0k,222
 lm_deluge/cache.py,sha256=VB1kv8rM2t5XWPR60uhszFcxLDnVKOe1oA5hYjVDjIo,4375
-lm_deluge/client.py,sha256=xGeJxLsm1Y-szUAVjNUYbbF51qLzlKcKZGhzNxZ37HE,28489
+lm_deluge/client.py,sha256=ERH0SkNvdM1zc8HYS5dxRGxVxUb4CXpUhveG3mz-w2I,28533
 lm_deluge/embed.py,sha256=m-X8UK4gV9KKD7Wv3yarAceMQaj7gR1JwzD_sB0MOQY,13183
 lm_deluge/errors.py,sha256=oHjt7YnxWbh-eXMScIzov4NvpJMo0-2r5J6Wh5DQ1tk,209
 lm_deluge/gemini_limits.py,sha256=V9mpS9JtXYz7AY6OuKyQp5TuIMRH1BVv9YrSNmGmHNA,1569
-lm_deluge/image.py,sha256=8tIPMZ5-R_JUVHXH8SpPGrmxBMSiU1XU3oFv4AkVr1c,7028
-lm_deluge/models.py,sha256=zAm4mPOTI81cuP6BBGUo1n8yaUhVHYQp97Jq1zLt1aI,40333
-lm_deluge/prompt.py,sha256=AVTvm2n-NV9PqFWJaKGeGYQbXpzTcKQGicBEIW8jfxQ,12710
+lm_deluge/image.py,sha256=hFbRajqEVQbkirAfOxsTPkeq-27Zl-so4AWBFeUbpBI,7161
+lm_deluge/models.py,sha256=67bgQnDoJKIen3B_cmWGtkW8Pi6zUWsnQFfPWMWOErM,41939
+lm_deluge/prompt.py,sha256=bhDAlfUQ_Fq6Wh-L9jOfoiMbDGyVKGkjGicnwKJWpcI,12680
 lm_deluge/rerank.py,sha256=tW1c3gQCAqaF8Ez-r-4qxYAcdKqxnLMxwHApKOUKwk4,11289
 lm_deluge/sampling_params.py,sha256=E2kewh1vz-1Qcy5xNBCzihfGgT_GcHYMfzaWb3FLiXs,739
 lm_deluge/tool.py,sha256=RVUW3E3FW11jCM-R7pIL1GpRs1YKCOjvTkL1D5xPetk,3196
 lm_deluge/tracker.py,sha256=Dk99scN_NeDEO0gkLO5efXiZq11Ga-k6cerUHWN7IWY,1292
 lm_deluge/api_requests/__init__.py,sha256=_aSpD6CJL9g6OpLPoChXiHjl4MH_OlGcKgfZaW8cgLM,71
-lm_deluge/api_requests/anthropic.py,sha256=HHmDOHs9euIwbjUpN8lLIX1FyAR0-fJ3-t_vW8T_Y2Y,6721
-lm_deluge/api_requests/base.py,sha256=PGI6gMnT0ZDhlkk9YWBRTUiwqPLan-O7yYt0MKyFjy0,14753
-lm_deluge/api_requests/cohere.py,sha256=1bCnV3Ot_n7CJKYLU_AoaKUuTgPUXUSBHPkAauQBimY,5089
-lm_deluge/api_requests/common.py,sha256=ZtUirAlYNE4CJOQPbNip-mWKOMXCJi2_malwYsUcqsg,642
-lm_deluge/api_requests/google.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lm_deluge/api_requests/openai.py,sha256=vjf2WFqQimroyGt_hX730lF8T83Bv29MzSyA8Ek0A9s,5663
-lm_deluge/api_requests/vertex.py,sha256=DxexjkkQOhrMgaDaVNEKo1E_0OhntUx4M_oDGfZUYgU,14609
+lm_deluge/api_requests/anthropic.py,sha256=URbiD-ANn_P3StFJVP2JoDWuoloZVsAUly8CGSyV2Kw,6618
+lm_deluge/api_requests/base.py,sha256=Yt5Bxd5C5mZrbAMQYDghk0KRhUChSbTEsVI8DoThZBs,14805
+lm_deluge/api_requests/common.py,sha256=EjwTnKrvgBx-HnRVt0kSJZ9RM7CM-QyhlIQkr1jxP-4,220
+lm_deluge/api_requests/mistral.py,sha256=ThlV1jBfhpAwkaqPKhdUq-lIq2OienRbhEaSK4cctvI,5370
+lm_deluge/api_requests/openai.py,sha256=YgJMUio23ks6VLv6BDBZAW6Bnfd2fpidSidaHXzyXFY,6135
 lm_deluge/api_requests/deprecated/bedrock.py,sha256=WrcIShCoO8JCUSlFOCHxg6KQCNTZfw3TpYTvSpYk4mA,11320
+lm_deluge/api_requests/deprecated/cohere.py,sha256=KgDScD6_bWhAzOY5BHZQKSA3kurt4KGENqC4wLsGmcU,5142
 lm_deluge/api_requests/deprecated/deepseek.py,sha256=FEApI93VAWDwuaqTooIyKMgONYqRhdUmiAPBRme-IYs,4582
 lm_deluge/api_requests/deprecated/mistral.py,sha256=pOfOZUM4U35I3Plch84SnAFpDAzouHcSNNMtgxRvjy4,4709
+lm_deluge/api_requests/deprecated/vertex.py,sha256=ygXz2RjdXErPCSBbiHLEWbf5_sSTIi31WoX0UaoYzRI,15275
 lm_deluge/llm_tools/__init__.py,sha256=TbZTETq9i_9yYskFWQKOG4pGh5ZiyE_D-h3RArfhGp4,231
 lm_deluge/llm_tools/extract.py,sha256=-GtyqJUxKvB567tk_NnCMklazz18xZBCPlAjYHTVUWg,3649
 lm_deluge/llm_tools/score.py,sha256=9oGA3-k2U5buHQXkXaEI9M4Wb5yysNhTLsPbGeghAlQ,2580
 lm_deluge/llm_tools/translate.py,sha256=iXyYvQZ8bC44FWhBk4qpdqjKM1WFF7Shq-H2PxhPgg4,1452
-lm_deluge/util/json.py,sha256=KuzyXvBCwoW2PLc6durR0aNA0MjlEcQprA1NTZmqh_g,5326
+lm_deluge/util/json.py,sha256=dCeG9j1D17rXmQJbKJH79X0CGof4Wlqd55TDg4D6ky8,5388
 lm_deluge/util/logprobs.py,sha256=UkBZakOxWluaLqHrjARu7xnJ0uCHVfLGHJdnYlEcutk,11768
 lm_deluge/util/pdf.py,sha256=zBcuh2IJxRfro6JPzQkAqdc6hUcrduFwb9aEoacNG9U,1590
 lm_deluge/util/validation.py,sha256=hz5dDb3ebvZrZhnaWxOxbNSVMI6nmaOODBkk0htAUhs,1575
-lm_deluge/util/xml.py,sha256=-yUKOZwsAY009w4ppQ8FI4hb5gDvLzMwcSgv88aEnaE,10578
-lm_deluge-0.0.4.dist-info/METADATA,sha256=eHZFvQYWovoOURJX3BhW_PfV8W4cMLf6YRKn_Qxiwo4,4957
-lm_deluge-0.0.4.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-lm_deluge-0.0.4.dist-info/top_level.txt,sha256=hqU-TJX93yBwpgkDtYcXyLr3t7TLSCCZ_reytJjwBaE,10
-lm_deluge-0.0.4.dist-info/RECORD,,
+lm_deluge/util/xml.py,sha256=Ft4zajoYBJR3HHCt2oHwGfymGLdvp_gegVmJ-Wqk4Ck,10547
+lm_deluge-0.0.6.dist-info/METADATA,sha256=c7Pof1ic06fW4ZiCZoq8N99Vx_-SIRVT_UeQ4-nWZQo,8267
+lm_deluge-0.0.6.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+lm_deluge-0.0.6.dist-info/top_level.txt,sha256=hqU-TJX93yBwpgkDtYcXyLr3t7TLSCCZ_reytJjwBaE,10
+lm_deluge-0.0.6.dist-info/RECORD,,