chatterer 0.1.5__tar.gz → 0.1.7__tar.gz

{chatterer-0.1.5 → chatterer-0.1.7}/PKG-INFO

@@ -1,150 +1,166 @@
-Metadata-Version: 2.2
-Name: chatterer
-Version: 0.1.5
-Summary: The highest-level interface for various LLM APIs.
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: instructor>=1.7.2
-Requires-Dist: langchain>=0.3.19
-Provides-Extra: all
-Requires-Dist: langchain-openai>=0.3.7; extra == "all"
-Requires-Dist: langchain-anthropic>=0.3.8; extra == "all"
-Requires-Dist: langchain-google-genai>=2.0.10; extra == "all"
-Requires-Dist: langchain-ollama>=0.2.3; extra == "all"
-
-# Chatterer
-
-**Simplified, Structured AI Assistant Framework**
-
-`chatterer` is a Python library designed as a type-safe LangChain wrapper for interacting with various language models (OpenAI, Anthropic, Gemini, Ollama, etc.). It supports structured outputs via Pydantic models, plain text responses, and asynchronous calls.
-
-The structured reasoning in `chatterer` is inspired by the [Atom-of-Thought](https://github.com/qixucen/atom) pipeline.
-
----
-
-## Quick Install
-
-```bash
-pip install chatterer
-```
-
----
-
-## Quickstart Example
-
-Generate text quickly using OpenAI:
-
-```python
-from chatterer import Chatterer
-
-chat = Chatterer.openai("gpt-4o-mini")
-response = chat.generate("What is the meaning of life?")
-print(response)
-```
-
-Messages can be input as plain strings or structured lists:
-
-```python
-response = chat.generate([{ "role": "user", "content": "What's 2+2?" }])
-print(response)
-```
-
-### Structured Output with Pydantic
-
-```python
-from pydantic import BaseModel
-
-class AnswerModel(BaseModel):
-    question: str
-    answer: str
-
-response = chat.generate_pydantic(AnswerModel, "What's the capital of France?")
-print(response.question, response.answer)
-```
-
-### Async Example
-
-```python
-import asyncio
-
-async def main():
-    response = await chat.agenerate("Explain async in Python briefly.")
-    print(response)
-
-asyncio.run(main())
-```
-
----
-
-## Atom-of-Thought Pipeline (AoT)
-
-`AoTPipeline` provides structured reasoning by:
-
-- Detecting question domains (general, math, coding, philosophy, multihop).
-- Decomposing questions recursively.
-- Generating direct, decomposition-based, and simplified answers.
-- Combining answers via ensemble.
-
-### AoT Usage Example
-
-```python
-from chatterer import Chatterer
-from chatterer.strategies import AoTStrategy, AoTPipeline
-
-pipeline = AoTPipeline(chatterer=Chatterer.openai(), max_depth=2)
-strategy = AoTStrategy(pipeline=pipeline)
-
-question = "What would Newton discover if hit by an apple falling from 100 meters?"
-answer = strategy.invoke(question)
-print(answer)
-```
-
----
-
-## Supported Models
-
-- **OpenAI**
-- **Anthropic**
-- **Google Gemini**
-- **Ollama** (local models)
-
-Initialize models easily:
-
-```python
-openai_chat = Chatterer.openai("gpt-4o-mini")
-anthropic_chat = Chatterer.anthropic("claude-3-7-sonnet-20250219")
-gemini_chat = Chatterer.google("gemini-2.0-flash")
-ollama_chat = Chatterer.ollama("deepseek-r1:1.5b")
-```
-
----
-
-## Advanced Features
-
-- **Streaming responses**
-- **Async/Await support**
-- **Structured outputs with Pydantic models**
-
----
-
-## Logging
-
-Built-in logging for easy debugging:
-
-```python
-import logging
-logging.basicConfig(level=logging.DEBUG)
-```
-
----
-
-## Contributing
-
-Feel free to open an issue or pull request.
-
----
-
-## License
-
-MIT License
-
+Metadata-Version: 2.4
+Name: chatterer
+Version: 0.1.7
+Summary: The highest-level interface for various LLM APIs.
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: instructor>=1.7.2
+Requires-Dist: langchain>=0.3.19
+Provides-Extra: dev
+Requires-Dist: neo4j-extension>=0.1.14; extra == "dev"
+Requires-Dist: colorama>=0.4.6; extra == "dev"
+Requires-Dist: ipykernel>=6.29.5; extra == "dev"
+Provides-Extra: conversion
+Requires-Dist: markdownify>=1.1.0; extra == "conversion"
+Requires-Dist: commonmark>=0.9.1; extra == "conversion"
+Requires-Dist: playwright>=1.50.0; extra == "conversion"
+Requires-Dist: pillow>=11.1.0; extra == "conversion"
+Requires-Dist: mistune>=3.1.2; extra == "conversion"
+Requires-Dist: markitdown>=0.0.2; extra == "conversion"
+Requires-Dist: pymupdf>=1.25.4; extra == "conversion"
+Provides-Extra: langchain-providers
+Requires-Dist: langchain-openai>=0.3.7; extra == "langchain-providers"
+Requires-Dist: langchain-anthropic>=0.3.8; extra == "langchain-providers"
+Requires-Dist: langchain-google-genai>=2.0.10; extra == "langchain-providers"
+Requires-Dist: langchain-ollama>=0.2.3; extra == "langchain-providers"
+Provides-Extra: all
+Requires-Dist: chatterer[langchain-providers]; extra == "all"
+Requires-Dist: chatterer[conversion]; extra == "all"
+Requires-Dist: chatterer[dev]; extra == "all"
+
+# Chatterer
+
+**Simplified, Structured AI Assistant Framework**
+
+`chatterer` is a Python library designed as a type-safe LangChain wrapper for interacting with various language models (OpenAI, Anthropic, Gemini, Ollama, etc.). It supports structured outputs via Pydantic models, plain text responses, and asynchronous calls.
+
+The structured reasoning in `chatterer` is inspired by the [Atom-of-Thought](https://github.com/qixucen/atom) pipeline.
+
+---
+
+## Quick Install
+
+```bash
+pip install chatterer
+```
+
+---
+
+## Quickstart Example
+
+Generate text quickly using OpenAI:
+
+```python
+from chatterer import Chatterer
+
+chat = Chatterer.openai("gpt-4o-mini")
+response = chat.generate("What is the meaning of life?")
+print(response)
+```
+
+Messages can be input as plain strings or structured lists:
+
+```python
+response = chat.generate([{ "role": "user", "content": "What's 2+2?" }])
+print(response)
+```
+
+### Structured Output with Pydantic
+
+```python
+from pydantic import BaseModel
+
+class AnswerModel(BaseModel):
+    question: str
+    answer: str
+
+response = chat.generate_pydantic(AnswerModel, "What's the capital of France?")
+print(response.question, response.answer)
+```
+
+### Async Example
+
+```python
+import asyncio
+
+async def main():
+    response = await chat.agenerate("Explain async in Python briefly.")
+    print(response)
+
+asyncio.run(main())
+```
+
+---
+
+## Atom-of-Thought Pipeline (AoT)
+
+`AoTPipeline` provides structured reasoning by:
+
+- Detecting question domains (general, math, coding, philosophy, multihop).
+- Decomposing questions recursively.
+- Generating direct, decomposition-based, and simplified answers.
+- Combining answers via ensemble.
+
+### AoT Usage Example
+
+```python
+from chatterer import Chatterer
+from chatterer.strategies import AoTStrategy, AoTPipeline
+
+pipeline = AoTPipeline(chatterer=Chatterer.openai(), max_depth=2)
+strategy = AoTStrategy(pipeline=pipeline)
+
+question = "What would Newton discover if hit by an apple falling from 100 meters?"
+answer = strategy.invoke(question)
+print(answer)
+```
+
+---
+
+## Supported Models
+
+- **OpenAI**
+- **Anthropic**
+- **Google Gemini**
+- **Ollama** (local models)
+
+Initialize models easily:
+
+```python
+openai_chat = Chatterer.openai("gpt-4o-mini")
+anthropic_chat = Chatterer.anthropic("claude-3-7-sonnet-20250219")
+gemini_chat = Chatterer.google("gemini-2.0-flash")
+ollama_chat = Chatterer.ollama("deepseek-r1:1.5b")
+```
+
+---
+
+## Advanced Features
+
+- **Streaming responses**
+- **Async/Await support**
+- **Structured outputs with Pydantic models**
+
+---
+
+## Logging
+
+Built-in logging for easy debugging:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+---
+
+## Contributing
+
+Feel free to open an issue or pull request.
+
+---
+
+## License
+
+MIT License
+

{chatterer-0.1.5 → chatterer-0.1.7}/README.md

@@ -1,136 +1,136 @@
-# Chatterer
-
-**Simplified, Structured AI Assistant Framework**
-
-`chatterer` is a Python library designed as a type-safe LangChain wrapper for interacting with various language models (OpenAI, Anthropic, Gemini, Ollama, etc.). It supports structured outputs via Pydantic models, plain text responses, and asynchronous calls.
-
-The structured reasoning in `chatterer` is inspired by the [Atom-of-Thought](https://github.com/qixucen/atom) pipeline.
-
----
-
-## Quick Install
-
-```bash
-pip install chatterer
-```
-
----
-
-## Quickstart Example
-
-Generate text quickly using OpenAI:
-
-```python
-from chatterer import Chatterer
-
-chat = Chatterer.openai("gpt-4o-mini")
-response = chat.generate("What is the meaning of life?")
-print(response)
-```
-
-Messages can be input as plain strings or structured lists:
-
-```python
-response = chat.generate([{ "role": "user", "content": "What's 2+2?" }])
-print(response)
-```
-
-### Structured Output with Pydantic
-
-```python
-from pydantic import BaseModel
-
-class AnswerModel(BaseModel):
-    question: str
-    answer: str
-
-response = chat.generate_pydantic(AnswerModel, "What's the capital of France?")
-print(response.question, response.answer)
-```
-
-### Async Example
-
-```python
-import asyncio
-
-async def main():
-    response = await chat.agenerate("Explain async in Python briefly.")
-    print(response)
-
-asyncio.run(main())
-```
-
----
-
-## Atom-of-Thought Pipeline (AoT)
-
-`AoTPipeline` provides structured reasoning by:
-
-- Detecting question domains (general, math, coding, philosophy, multihop).
-- Decomposing questions recursively.
-- Generating direct, decomposition-based, and simplified answers.
-- Combining answers via ensemble.
-
-### AoT Usage Example
-
-```python
-from chatterer import Chatterer
-from chatterer.strategies import AoTStrategy, AoTPipeline
-
-pipeline = AoTPipeline(chatterer=Chatterer.openai(), max_depth=2)
-strategy = AoTStrategy(pipeline=pipeline)
-
-question = "What would Newton discover if hit by an apple falling from 100 meters?"
-answer = strategy.invoke(question)
-print(answer)
-```
-
----
-
-## Supported Models
-
-- **OpenAI**
-- **Anthropic**
-- **Google Gemini**
-- **Ollama** (local models)
-
-Initialize models easily:
-
-```python
-openai_chat = Chatterer.openai("gpt-4o-mini")
-anthropic_chat = Chatterer.anthropic("claude-3-7-sonnet-20250219")
-gemini_chat = Chatterer.google("gemini-2.0-flash")
-ollama_chat = Chatterer.ollama("deepseek-r1:1.5b")
-```
-
----
-
-## Advanced Features
-
-- **Streaming responses**
-- **Async/Await support**
-- **Structured outputs with Pydantic models**
-
----
-
-## Logging
-
-Built-in logging for easy debugging:
-
-```python
-import logging
-logging.basicConfig(level=logging.DEBUG)
-```
-
----
-
-## Contributing
-
-Feel free to open an issue or pull request.
-
----
-
-## License
-
-MIT License
-
+# Chatterer
+
+**Simplified, Structured AI Assistant Framework**
+
+`chatterer` is a Python library designed as a type-safe LangChain wrapper for interacting with various language models (OpenAI, Anthropic, Gemini, Ollama, etc.). It supports structured outputs via Pydantic models, plain text responses, and asynchronous calls.
+
+The structured reasoning in `chatterer` is inspired by the [Atom-of-Thought](https://github.com/qixucen/atom) pipeline.
+
+---
+
+## Quick Install
+
+```bash
+pip install chatterer
+```
+
+---
+
+## Quickstart Example
+
+Generate text quickly using OpenAI:
+
+```python
+from chatterer import Chatterer
+
+chat = Chatterer.openai("gpt-4o-mini")
+response = chat.generate("What is the meaning of life?")
+print(response)
+```
+
+Messages can be input as plain strings or structured lists:
+
+```python
+response = chat.generate([{ "role": "user", "content": "What's 2+2?" }])
+print(response)
+```
+
+### Structured Output with Pydantic
+
+```python
+from pydantic import BaseModel
+
+class AnswerModel(BaseModel):
+    question: str
+    answer: str
+
+response = chat.generate_pydantic(AnswerModel, "What's the capital of France?")
+print(response.question, response.answer)
+```
+
+### Async Example
+
+```python
+import asyncio
+
+async def main():
+    response = await chat.agenerate("Explain async in Python briefly.")
+    print(response)
+
+asyncio.run(main())
+```
+
+---
+
+## Atom-of-Thought Pipeline (AoT)
+
+`AoTPipeline` provides structured reasoning by:
+
+- Detecting question domains (general, math, coding, philosophy, multihop).
+- Decomposing questions recursively.
+- Generating direct, decomposition-based, and simplified answers.
+- Combining answers via ensemble.
+
+### AoT Usage Example
+
+```python
+from chatterer import Chatterer
+from chatterer.strategies import AoTStrategy, AoTPipeline
+
+pipeline = AoTPipeline(chatterer=Chatterer.openai(), max_depth=2)
+strategy = AoTStrategy(pipeline=pipeline)
+
+question = "What would Newton discover if hit by an apple falling from 100 meters?"
+answer = strategy.invoke(question)
+print(answer)
+```
+
+---
+
+## Supported Models
+
+- **OpenAI**
+- **Anthropic**
+- **Google Gemini**
+- **Ollama** (local models)
+
+Initialize models easily:
+
+```python
+openai_chat = Chatterer.openai("gpt-4o-mini")
+anthropic_chat = Chatterer.anthropic("claude-3-7-sonnet-20250219")
+gemini_chat = Chatterer.google("gemini-2.0-flash")
+ollama_chat = Chatterer.ollama("deepseek-r1:1.5b")
+```
+
+---
+
+## Advanced Features
+
+- **Streaming responses**
+- **Async/Await support**
+- **Structured outputs with Pydantic models**
+
+---
+
+## Logging
+
+Built-in logging for easy debugging:
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+---
+
+## Contributing
+
+Feel free to open an issue or pull request.
+
+---
+
+## License
+
+MIT License
+

chatterer-0.1.7/chatterer/__init__.py

@@ -0,0 +1,39 @@
+from .language_model import Chatterer
+from .messages import (
+    AIMessage,
+    BaseMessage,
+    HumanMessage,
+    SystemMessage,
+)
+from .strategies import (
+    AoTPipeline,
+    AoTPrompter,
+    AoTStrategy,
+    BaseStrategy,
+)
+from .tools import (
+    anything_to_markdown,
+    citation_chunker,
+    get_default_html_to_markdown_options,
+    html_to_markdown,
+    pdf_to_text,
+    pyscripts_to_snippets,
+)
+
+__all__ = [
+    "BaseStrategy",
+    "Chatterer",
+    "AoTStrategy",
+    "AoTPipeline",
+    "AoTPrompter",
+    "html_to_markdown",
+    "anything_to_markdown",
+    "pdf_to_text",
+    "get_default_html_to_markdown_options",
+    "pyscripts_to_snippets",
+    "citation_chunker",
+    "BaseMessage",
+    "HumanMessage",
+    "SystemMessage",
+    "AIMessage",
+]