chatlas 0.8.1__py3-none-any.whl → 0.9.1__py3-none-any.whl

chatlas-0.8.1.dist-info/METADATA

@@ -1,383 +0,0 @@
-Metadata-Version: 2.4
-Name: chatlas
-Version: 0.8.1
-Summary: A simple and consistent interface for chatting with LLMs
-Project-URL: Homepage, https://posit-dev.github.io/chatlas
-Project-URL: Documentation, https://posit-dev.github.io/chatlas
-Project-URL: Repository, https://github.com/posit-dev/chatlas
-Project-URL: Issues, https://github.com/posit-dev/chatlas/issues/
-Project-URL: Changelog, https://github.com/posit-dev/chatlas/blob/main/CHANGELOG.md
-Author-email: Carson Sievert <carson@posit.co>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.9
-Requires-Dist: jinja2
-Requires-Dist: openai
-Requires-Dist: orjson
-Requires-Dist: pydantic>=2.0
-Requires-Dist: requests
-Requires-Dist: rich
-Provides-Extra: anthropic
-Requires-Dist: anthropic; extra == 'anthropic'
-Provides-Extra: azure-openai
-Provides-Extra: bedrock-anthropic
-Requires-Dist: anthropic[bedrock]; extra == 'bedrock-anthropic'
-Provides-Extra: databricks
-Requires-Dist: databricks-sdk; extra == 'databricks'
-Provides-Extra: dev
-Requires-Dist: anthropic[bedrock]; extra == 'dev'
-Requires-Dist: databricks-sdk; extra == 'dev'
-Requires-Dist: google-genai>=1.14.0; extra == 'dev'
-Requires-Dist: htmltools; extra == 'dev'
-Requires-Dist: matplotlib; extra == 'dev'
-Requires-Dist: numpy>1.24.4; extra == 'dev'
-Requires-Dist: openai; extra == 'dev'
-Requires-Dist: pillow; extra == 'dev'
-Requires-Dist: python-dotenv; extra == 'dev'
-Requires-Dist: ruff>=0.6.5; extra == 'dev'
-Requires-Dist: shiny; extra == 'dev'
-Requires-Dist: snowflake-ml-python>=1.8.4; extra == 'dev'
-Requires-Dist: tenacity; extra == 'dev'
-Requires-Dist: tiktoken; extra == 'dev'
-Requires-Dist: torch; (python_version <= '3.11') and extra == 'dev'
-Provides-Extra: docs
-Requires-Dist: griffe>=1; extra == 'docs'
-Requires-Dist: ipykernel; extra == 'docs'
-Requires-Dist: ipywidgets; extra == 'docs'
-Requires-Dist: nbclient; extra == 'docs'
-Requires-Dist: nbformat; extra == 'docs'
-Requires-Dist: numpy; extra == 'docs'
-Requires-Dist: pandas; extra == 'docs'
-Requires-Dist: pyyaml; extra == 'docs'
-Requires-Dist: quartodoc>=0.7; extra == 'docs'
-Requires-Dist: sentence-transformers; extra == 'docs'
-Provides-Extra: github
-Provides-Extra: google
-Requires-Dist: google-genai>=1.14.0; extra == 'google'
-Provides-Extra: groq
-Provides-Extra: ollama
-Provides-Extra: openai
-Provides-Extra: perplexity
-Provides-Extra: snowflake
-Requires-Dist: snowflake-ml-python; extra == 'snowflake'
-Provides-Extra: test
-Requires-Dist: pyright>=1.1.379; extra == 'test'
-Requires-Dist: pytest-asyncio; extra == 'test'
-Requires-Dist: pytest>=8.3.2; extra == 'test'
-Requires-Dist: syrupy>=4; extra == 'test'
-Provides-Extra: vertex
-Requires-Dist: google-genai>=1.14.0; extra == 'vertex'
-Description-Content-Type: text/markdown
-
-<h1 class="unnumbered unlisted"> chatlas <a href="https://posit-dev.github.io/chatlas"><img src="docs/images/logo.png" align="right" height="138" alt="chatlas website" /></a> </h1> 
-
-
-
-<p>
-<!-- badges start -->
-<a href="https://pypi.org/project/chatlas/"><img alt="PyPI" src="https://img.shields.io/pypi/v/chatlas?logo=python&logoColor=white&color=orange"></a>
-<a href="https://choosealicense.com/licenses/mit/"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
-<a href="https://github.com/posit-dev/chatlas"><img src="https://github.com/posit-dev/chatlas/actions/workflows/test.yml/badge.svg?branch=main" alt="Python Tests"></a>
-<!-- badges end -->
-</p>
-
-chatlas provides a simple and unified interface across large language model (llm) providers in Python. 
-It helps you prototype faster by abstracting away complexity from common tasks like streaming chat interfaces, tool calling, structured output, and much more.
-Switching providers is also as easy as changing one line of code, but you can also reach for provider-specific features when you need them.
-Developer experience is also a key focus of chatlas: typing support, rich console output, and extension points are all included.
-
-(Looking for something similar to chatlas, but in R? Check out [ellmer](https://ellmer.tidyverse.org/)!)
-
-## Install
-
-Install the latest stable release from PyPI:
-
-```bash
-pip install -U chatlas
-```
-
-Or, install the latest development version from GitHub:
-
-```bash
-pip install -U git+https://github.com/posit-dev/chatlas
-```
-
-## Model providers
-
-`chatlas` supports a variety of model providers. See the [API reference](https://posit-dev.github.io/chatlas/reference/index.html) for more details (like managing credentials) on each provider.
-
-* Anthropic (Claude): [`ChatAnthropic()`](https://posit-dev.github.io/chatlas/reference/ChatAnthropic.html).
-* GitHub model marketplace: [`ChatGithub()`](https://posit-dev.github.io/chatlas/reference/ChatGithub.html).
-* Google (Gemini): [`ChatGoogle()`](https://posit-dev.github.io/chatlas/reference/ChatGoogle.html).
-* Groq: [`ChatGroq()`](https://posit-dev.github.io/chatlas/reference/ChatGroq.html).
-* Ollama local models: [`ChatOllama()`](https://posit-dev.github.io/chatlas/reference/ChatOllama.html).
-* OpenAI: [`ChatOpenAI()`](https://posit-dev.github.io/chatlas/reference/ChatOpenAI.html).
-* perplexity.ai: [`ChatPerplexity()`](https://posit-dev.github.io/chatlas/reference/ChatPerplexity.html).
-
-It also supports the following enterprise cloud providers:
-
-* AWS Bedrock: [`ChatBedrockAnthropic()`](https://posit-dev.github.io/chatlas/reference/ChatBedrockAnthropic.html).
-* Azure OpenAI: [`ChatAzureOpenAI()`](https://posit-dev.github.io/chatlas/reference/ChatAzureOpenAI.html).
-* Databricks: [`ChatDatabricks()`](https://posit-dev.github.io/chatlas/reference/ChatDatabricks.html).
-* Snowflake Cortex: [`ChatSnowflake()`](https://posit-dev.github.io/chatlas/reference/ChatSnowflake.html).
-* Vertex AI: [`ChatVertex()`](https://posit-dev.github.io/chatlas/reference/ChatVertex.html).
-
-To use a model provider that isn't listed here, you have two options:
-
-1. If the model is OpenAI compatible, use `ChatOpenAI()` with the appropriate `base_url` and `api_key` (see [`ChatGithub`](https://github.com/posit-dev/chatlas/blob/main/chatlas/_github.py) for a reference).
-2. If you're motivated, implement a new provider by subclassing [`Provider`](https://github.com/posit-dev/chatlas/blob/main/chatlas/_provider.py) and implementing the required methods.
-
-
-## Model choice
-
-If you're using chatlas inside your organisation, you'll be limited to what your org allows, which is likely to be one provided by a big cloud provider (e.g. `ChatAzureOpenAI()` and `ChatBedrockAnthropic()`). If you're using chatlas for your own personal exploration, you have a lot more freedom so we have a few recommendations to help you get started:
-
-- `ChatOpenAI()` or `ChatAnthropic()` are both good places to start. `ChatOpenAI()` defaults to **GPT-4o**, but you can use `model = "gpt-4o-mini"` for a cheaper lower-quality model, or `model = "o1-mini"` for more complex reasoning.  `ChatAnthropic()` is similarly good; it defaults to **Claude 3.5 Sonnet** which we have found to be particularly good at writing code.
-
-- `ChatGoogle()` is great for large prompts, because it has a much larger context window than other models. It allows up to 1 million tokens, compared to Claude 3.5 Sonnet's 200k and GPT-4o's 128k.
-
-- `ChatOllama()`, which uses [Ollama](https://ollama.com), allows you to run models on your own computer. The biggest models you can run locally aren't as good as the state of the art hosted models, but they also don't share your data and and are effectively free.
-
-## Using chatlas
-
-You can chat via `chatlas` in several different ways, depending on whether you are working interactively or programmatically. They all start with creating a new chat object:
-
-```python
-from chatlas import ChatOpenAI
-
-chat = ChatOpenAI(
-  model = "gpt-4o",
-  system_prompt = "You are a friendly but terse assistant.",
-)
-```
-
-### Interactive console
-
-From a `chat` instance, it's simple to start a web-based or terminal-based chat console, which is great for testing the capabilities of the model. In either case, responses stream in real-time, and context is preserved across turns.
-
-```python
-chat.app()
-```
-
-<div align="center">
-<img width="500" alt="A web app for chatting with an LLM via chatlas" src="https://github.com/user-attachments/assets/e43f60cb-3686-435a-bd11-8215cb024d2e" class="border rounded">
-</div>
-
-
-Or, if you prefer to work from the terminal:
-
-```python
-chat.console()
-```
-
-```
-Entering chat console. Press Ctrl+C to quit.
-
-?> Who created Python?
-
-Python was created by Guido van Rossum. He began development in the late 1980s and released the first version in 1991. 
-
-?> Where did he develop it?
-
-Guido van Rossum developed Python while working at Centrum Wiskunde & Informatica (CWI) in the Netherlands.     
-```
-
-
-### The `.chat()` method
-
-For a more programmatic approach, you can use the `.chat()` method to ask a question and get a response. By default, the response prints to a [rich](https://github.com/Textualize/rich) console as it streams in:
-
-```python
-chat.chat("What preceding languages most influenced Python?")
-```
-
-```
-Python was primarily influenced by ABC, with additional inspiration from C,
-Modula-3, and various other languages.
-```
-
-To ask a question about an image, pass one or more additional input arguments using `content_image_file()` and/or `content_image_url()`:
-
-```python
-from chatlas import content_image_url
-
-chat.chat(
-    content_image_url("https://www.python.org/static/img/python-logo.png"),
-    "Can you explain this logo?"
-)
-```
-
-```
-The Python logo features two intertwined snakes in yellow and blue,
-representing the Python programming language. The design symbolizes...
-```
-
-To get the full response as a string, use the built-in `str()` function. Optionally, you can also suppress the rich console output by setting `echo="none"`:
-
-```python
-response = chat.chat("Who is Posit?", echo="none")
-print(str(response))
-```
-
-As we'll see in later articles, `echo="all"` can also be useful for debugging, as it shows additional information, such as tool calls.
-
-### The `.stream()` method
-
-If you want to do something with the response in real-time (i.e., as it arrives in chunks), use the `.stream()` method. This method returns an iterator that yields each chunk of the response as it arrives:
-
-```python
-response = chat.stream("Who is Posit?")
-for chunk in response:
-    print(chunk, end="")
-```
-
-The `.stream()` method can also be useful if you're [building a chatbot](https://posit-dev.github.io/chatlas/web-apps.html) or other programs that needs to display responses as they arrive.
-
-
-### Tool calling 
-
-Tool calling is as simple as passing a function with type hints and docstring to `.register_tool()`.
-
-```python
-import sys
-
-def get_current_python_version() -> str:
-    """Get the current version of Python."""
-    return sys.version
-
-chat.register_tool(get_current_python_version)
-chat.chat("What's the current version of Python?")
-```
-
-```
-The current version of Python is 3.13.
-```
-
-Learn more in the [tool calling article](https://posit-dev.github.io/chatlas/tool-calling.html)
-
-### Structured data
-
-Structured data (i.e., structured output) is as simple as passing a [pydantic](https://docs.pydantic.dev/latest/) model to `.extract_data()`.
-
-```python
-from pydantic import BaseModel
-
-class Person(BaseModel):
-    name: str
-    age: int
-
-chat.extract_data(
-    "My name is Susan and I'm 13 years old", 
-    data_model=Person,
-)
-```
-
-```
-{'name': 'Susan', 'age': 13}
-```
-
-Learn more in the [structured data article](https://posit-dev.github.io/chatlas/structured-data.html)
-
-### Multi-modal input
-
-Attach images and pdfs when submitting input to using any one of the `content_*` functions.
-
-```python
-from chatlas import content_image_url
-
-chat.chat(
-    content_image_url("https://www.python.org/static/img/python-logo.png"),
-    "What do you see in this image?"
-)
-```
-
-```
-This image displays the logo of the Python programming language. It features the word "python" alongside the distinctive two snake heads logo, which is colored in blue and yellow.  
-```
-
-Learn more in the [content reference pages](https://posit-dev.github.io/chatlas/reference/content_image_url.html) for more details on the available content types.
-
-
-### Export chat
-
-Easily get a full markdown or HTML export of a conversation:
-
-```python
-chat.export("index.html", title="Python Q&A")
-```
-
-If the export doesn't have all the information you need, you can also access the full conversation history via the `.get_turns()` method:
-
-```python
-chat.get_turns()
-```
-
-And, if the conversation is too long, you can specify which turns to include:
-
-```python
-chat.export("index.html", turns=chat.get_turns()[-5:])
-```
-
-### Async
-
-`chat` methods tend to be synchronous by default, but you can use the async flavor by appending `_async` to the method name:
-
-```python
-import asyncio
-
-async def main():
-    await chat.chat_async("What is the capital of France?")
-
-asyncio.run(main())
-```
-
-### Typing support
-
-`chatlas` has full typing support, meaning that, among other things, autocompletion just works in your favorite editor:
-
-<div align="center">
-<img width="500" alt="Autocompleting model options in ChatOpenAI" src="https://github.com/user-attachments/assets/163d6d8a-7d58-422d-b3af-cc9f2adee759" class="rounded">
-</div>
-
-
-
-### Troubleshooting
-
-Sometimes things like token limits, tool errors, or other issues can cause problems that are hard to diagnose. 
-In these cases, the `echo="all"` option is helpful for getting more information about what's going on under the hood.
-
-```python
-chat.chat("What is the capital of France?", echo="all")
-```
-
-This shows important information like tool call results, finish reasons, and more.
-
-If the problem isn't self-evident, you can also reach into the `.get_last_turn()`, which contains the full response object, with full details about the completion.
-
-
-<div align="center">
-  <img width="500" alt="Turn completion details with typing support" src="https://github.com/user-attachments/assets/eaea338d-e44a-4e23-84a7-2e998d8af3ba" class="rounded">
-</div>
-
-
-For monitoring issues in a production (or otherwise non-interactive) environment, you may want to enabling logging. Also, since `chatlas` builds on top of packages like `anthropic` and `openai`, you can also enable their debug logging to get lower-level information, like HTTP requests and response codes.
-
-```shell
-$ export CHATLAS_LOG=info
-$ export OPENAI_LOG=info
-$ export ANTHROPIC_LOG=info
-```
-
-### Next steps
-
-If you're new to world LLMs, you might want to read the [Get Started](https://posit-dev.github.io/chatlas/get-started.html) guide, which covers some basic concepts and terminology.
-
-Once you're comfortable with the basics, you can explore more in-depth topics like [prompt design](https://posit-dev.github.io/chatlas/prompt-design.html) or the [API reference](https://posit-dev.github.io/chatlas/reference/index.html).

chatlas-0.8.1.dist-info/RECORD

@@ -1,46 +0,0 @@
-chatlas/__init__.py,sha256=vZpEIGNqb8pJ5QCEYjHcKuoc0HDTkuhR40sJfKdhN7s,1571
-chatlas/_anthropic.py,sha256=iF2aFS07T4I2Zlw5hI6Y-PjIBH4cG6ibOgVy12dI_6I,24885
-chatlas/_auto.py,sha256=HsAvVwpSOkI9fdC35YX8beaE2IBnWLWTzOzu0ny951o,6129
-chatlas/_callbacks.py,sha256=3RpPaOQonTqScjXbaShgKJ1Rc-YxzWerxKRBjVssFnc,1838
-chatlas/_chat.py,sha256=KJDXAV7AS_PFGuSdx90AKzBw0PMKBeZpIF4OmHrPuMw,57864
-chatlas/_content.py,sha256=KtQfJ3CATk_TGzGzihc_wWRuHdlLWp9Dr-OgxZQbOQE,15931
-chatlas/_content_image.py,sha256=EUK6wAint-JatLsiwvaPDu4D3W-NcIsDCkzABkXgfDg,8304
-chatlas/_content_pdf.py,sha256=cffeuJxzhUDukQ-Srkmpy62M8X12skYpU_FVq-Wvya4,2420
-chatlas/_databricks.py,sha256=56dInk3UjQ5HqGiysn9TJ9hat745MhaFEn-IPfnR4vE,4696
-chatlas/_display.py,sha256=wyQzSc6z1VqrJfkTLkw1wQcti9s1Pr4qT8UxFJESn4U,4664
-chatlas/_github.py,sha256=xdGsvWvlbGMc1lgEM_oRL5p-wuxaZG-lu6a_4zxV-4Y,4235
-chatlas/_google.py,sha256=pwnomFcDEzPXQQfFifoH2FrbDvOgRIIyjcNoJ8Hvv-I,19397
-chatlas/_groq.py,sha256=0ou8iiAeI8EqjNKsLZhljQffSVOj8eCQEtW7-stZToY,4022
-chatlas/_interpolate.py,sha256=ykwLP3x-ya9Q33U4knSU75dtk6pzJAeythEEIW-43Pc,3631
-chatlas/_live_render.py,sha256=UMZltE35LxziDKPMEeDwQ9meZ95SeqwhJi7j-y9pcro,4004
-chatlas/_logging.py,sha256=weKvXZDIZ88X7X61ruXM_S0AAhQ5mgiW9dR-km8x7Mg,3324
-chatlas/_merge.py,sha256=SGj_BetgA7gaOqSBKOhYmW3CYeQKTEehFrXvx3y4OYE,3924
-chatlas/_ollama.py,sha256=_5Na11A7Hrs83CK8x542UHDvpLjQPyTJ9WM03eFDqKA,3627
-chatlas/_openai.py,sha256=qkU2DWOTsEVfjiAk4LDRszErVGLswiLwwim1zZnHn8o,23968
-chatlas/_perplexity.py,sha256=POp_Lc8RlSEsHIHhFlHOE8IVsOb2nf7mHQZvyQp49_U,4304
-chatlas/_provider.py,sha256=YmdBbz_u5aP_kBxl6s26OPiSnWG_vZ_fvf9L2qvBmyI,3809
-chatlas/_snowflake.py,sha256=y9Lu5SFGsJ1QqQD0Xx7vsAwcBtw2_MWT1Vu7e0HQis0,24098
-chatlas/_tokens.py,sha256=3W3EPUp9eWXUiwuzJwEPBv43AUznbK46pm59Htti7z4,2392
-chatlas/_tokens_old.py,sha256=L9d9oafrXvEx2u4nIn_Jjn7adnQyLBnYBuPwJUE8Pl8,5005
-chatlas/_tools.py,sha256=Qucyx_Pq-DX66r5xsZ7VRNxrIMS_se-FS7HH7jbB1A0,6085
-chatlas/_turn.py,sha256=7pve6YmD-L4c7Oxd6_ZAPkDudJ8AMpa6pP-pSroA1dM,5067
-chatlas/_typing_extensions.py,sha256=YdzmlyPSBpIEcsOkoz12e6jETT1XEMV2Q72haE4cfwY,1036
-chatlas/_utils.py,sha256=lli8ChbPUwEPebW8AoOoNoqiA95SVtoW2gb6ymj9gw4,4028
-chatlas/_version.py,sha256=Qh9qKQ7_wMS7wH5nRvhQyYwD9deQawM2RC-sVdT7RyM,511
-chatlas/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-chatlas/types/__init__.py,sha256=P_EDL4eqsigKwB-u2qRmKlYQS5Y65m7oWjGC3cYmxO4,719
-chatlas/types/anthropic/__init__.py,sha256=OwubA-DPHYpYo0XyRyAFwftOI0mOxtHzAyhUSLcDx54,417
-chatlas/types/anthropic/_client.py,sha256=G0LRhoFBcsSOMr5qhP-0rAScsVXaVlHCpggfVp54bnQ,690
-chatlas/types/anthropic/_client_bedrock.py,sha256=mNazQlu0pQt8JdzrYn3LKNgE4n732GjhQUJdQQK9QkY,785
-chatlas/types/anthropic/_submit.py,sha256=FJPtswPf_NTV3kAXlFODin3bFOqYNdamopjIaVSSr24,3417
-chatlas/types/google/__init__.py,sha256=ZJhi8Kwvio2zp8T1TQqmvdHqkS-Khb6BGESPjREADgo,337
-chatlas/types/google/_client.py,sha256=t7aKbxYq_xOA1Z3RnWcjewifdQFSHi7vKEj6MyKMCJk,729
-chatlas/types/google/_submit.py,sha256=b-ZqMvI551Ia7pFlWdqUQJjov3neHmVwLFw-P2bgU8w,1883
-chatlas/types/openai/__init__.py,sha256=Q2RAr1bSH1nHsxICK05nAmKmxdhKmhbBkWD_XHiVSrI,411
-chatlas/types/openai/_client.py,sha256=YGm_EHtRSSHeeOZe-CV7oNvMJpEblEta3UTuU7lSRO8,754
-chatlas/types/openai/_client_azure.py,sha256=jx8D_p46CLDGzTP-k-TtGzj-f3junj6or-86m8DD_0w,858
-chatlas/types/openai/_submit.py,sha256=FmDBq8Wg8R-GB3mFBCvAPHyniCyIkgrzwd_iOiAOLM8,6607
-chatlas-0.8.1.dist-info/METADATA,sha256=uQDhm3goorhNSXrkOw5kN7J51tiCharGydKMv2wslZo,15255
-chatlas-0.8.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-chatlas-0.8.1.dist-info/licenses/LICENSE,sha256=zyuGzPOC7CcbOaBHsQ3UEyKYRO56KDUkor0OA4LqqDg,1081
-chatlas-0.8.1.dist-info/RECORD,,