stirrup 0.1.0__tar.gz

stirrup-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Artificial Analysis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

stirrup-0.1.0/PKG-INFO

@@ -0,0 +1,318 @@
+Metadata-Version: 2.3
+Name: stirrup
+Version: 0.1.0
+Summary: The lightweight foundation for building agents
+Keywords: ai,agent,llm,openai,anthropic,tools,framework
+Author: Artificial Analysis, Inc.
+Author-email: Artificial Analysis, Inc. <info@artificialanalysis.ai>
+License: MIT License
+         
+         Copyright (c) 2025 Artificial Analysis
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: filetype>=1.0.0
+Requires-Dist: httpx>=0.20.0
+Requires-Dist: json-schema-to-pydantic>=0.2.0
+Requires-Dist: moviepy>=2.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pillow>=10.4.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: tenacity>=5.0.0
+Requires-Dist: trafilatura>=1.9.0
+Requires-Dist: stirrup[litellm,e2b,docker,mcp] ; extra == 'all'
+Requires-Dist: docker>=7.0.0 ; extra == 'docker'
+Requires-Dist: python-dotenv>=1.0.0 ; extra == 'docker'
+Requires-Dist: e2b-code-interpreter>=2.3.0 ; extra == 'e2b'
+Requires-Dist: litellm>=1.79.3 ; extra == 'litellm'
+Requires-Dist: mcp>=1.9.0 ; extra == 'mcp'
+Requires-Python: >=3.12
+Project-URL: Documentation, https://artificialanalysis.github.io/Stirrup
+Project-URL: Homepage, https://github.com/ArtificialAnalysis/Stirrup
+Project-URL: Repository, https://github.com/ArtificialAnalysis/Stirrup
+Provides-Extra: all
+Provides-Extra: docker
+Provides-Extra: e2b
+Provides-Extra: litellm
+Provides-Extra: mcp
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="">
+    <picture>
+        <img alt="Stirrup" src="assets/stirrup-banner.png" width="700">
+    </picture>
+  </a>
+  <br></br>
+  <h1>The lightweight foundation for building agents</h1>
+<br>
+</div>
+
+
+<p align="center">
+  <a href="https://pypi.python.org/pypi/stirrup"><img src="https://img.shields.io/pypi/v/stirrup" alt="PyPI version" /></a>&nbsp;<!--
+  --><a href="https://github.com/ArtificialAnalysis/Stirrup/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ArtificialAnalysis/Stirrup" alt="License" /></a>&nbsp;<!--
+  --><a href="https://artificialanalysis.github.io/Stirrup"><img src="https://img.shields.io/badge/MkDocs-4F46E5?logo=materialformkdocs&logoColor=fff" alt="MkDocs" /></a>
+</p>
+
+
+Stirrup is a lightweight framework, or starting point template, for building agents. It differs from other agent frameworks by:
+
+- **Working with the model, not against it:** Stirrup gets out of the way and lets the model choose its own approach to completing tasks (similar to Claude Code). Many frameworks impose rigid workflows that can degrade results.
+- **Best practices and tools built-in:** We analyzed the leading agents (Claude Code, Codex, and others) to understand and incorporate best practices relating to topics like context management and foundational tools (e.g., code execution).
+- **Fully customizable:** Use Stirrup as a package or as a starting template to build your own fully customized agents.
+
+## Features
+
+- **Essential tools built-in:**
+  - Online search / web browsing
+  - Code execution (local, Docker container, E2B sandbox)
+  - MCP client
+  - Document input and output
+- **Flexible tool execution:** A generic `Tool` class allows easy tool definition and extension
+- **Context management:** Automatically summarizes conversation history when approaching context limits
+- **Flexible provider support:** Pre-built support for OpenAI-compatible APIs and LiteLLM, or bring your own client
+- **Multimodal support:** Process images, video, and audio with automatic format conversion
+
+## Installation
+
+```bash
+# Core framework
+uv pip install stirrup      # or: uv add stirrup
+
+# With all optional components
+uv pip install stirrup[all]  # or: uv add stirrup[all]
+
+# Individual extras
+uv pip install stirrup[litellm]  # or: uv add stirrup[litellm]
+uv pip install stirrup[docker]   # or: uv add stirrup[docker]
+uv pip install stirrup[e2b]      # or: uv add stirrup[e2b]
+uv pip install stirrup[mcp]      # or: uv add stirrup[mcp]
+```
+
+## Quick Start
+
+```python
+import asyncio
+
+from stirrup import Agent
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+
+
+async def main() -> None:
+    """Run an agent that searches the web and creates a chart."""
+
+    # Create client using ChatCompletionsClient
+    # Automatically uses OPENROUTER_API_KEY environment variable
+    client = ChatCompletionsClient(
+        base_url="https://openrouter.ai/api/v1",
+        model="anthropic/claude-sonnet-4.5",
+    )
+
+    # As no tools are provided, the agent will use the default tools, which consist of:
+    # - Web tools (web search and web fetching, note web search requires BRAVE_API_KEY)
+    # - Local code execution tool (to execute shell commands)
+    agent = Agent(client=client, name="agent", max_turns=15)
+
+    # Run with session context - handles tool lifecycle, logging and file outputs
+    async with agent.session(output_dir="./output/getting_started_example") as session:
+        finish_params, history, metadata = await session.run(
+            """
+            What is the population of Australia over the last 3 years? Search the web to find out and create a
+            simple chart using matplotlib showing the current population per year."""
+        )
+
+        print("Finish params: ", finish_params)
+        print("History: ", history)
+        print("Metadata: ", metadata)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+> **Note:** This example uses OpenRouter. Set `OPENROUTER_API_KEY` in your environment before running. Web search requires a `BRAVE_API_KEY`. The agent will still work without it, but web search will be unavailable.
+
+## How It Works
+
+- **`Agent`** - Configures and runs the agent loop until a finish tool is called or max turns reached
+- **`session()`** - Context manager that sets up tools, manages files, and handles cleanup
+- **`Tool`** - Define tools with Pydantic parameters
+- **`ToolProvider`** - Manage tools that require lifecycle (connections, temp directories, etc.)
+- **`DEFAULT_TOOLS`** - Standard tools included by default: code execution and web tools
+
+## Using Other LLM Providers
+
+For non-OpenAI providers, change the base URL of the `ChatCompletionsClient`, use the `LiteLLMClient` (requires installation of optional `stirrup[litellm]` dependencies), or create your own client.
+
+### OpenAI-Compatible APIs
+
+```python
+# Create client using Deepseek's OpenAI-compatible endpoint
+client = ChatCompletionsClient(
+    base_url="https://api.deepseek.com",
+    model="deepseek-chat",  # or "deepseek-reasoner" for R1
+    api_key=os.environ["DEEPSEEK_API_KEY"],
+)
+
+agent = Agent(client=client, name="deepseek_agent")
+```
+
+### LiteLLM (Anthropic, Google, etc.)
+
+```python
+# Create LiteLLM client for Anthropic Claude
+# See https://docs.litellm.ai/docs/providers for all supported providers
+client = LiteLLMClient(
+    model_slug="anthropic/claude-sonnet-4-5",
+    max_tokens=200_000,
+)
+
+# Pass client to Agent - model info comes from client.model_slug
+agent = Agent(
+    client=client,
+    name="claude_agent",
+)
+```
+
+See [LiteLLM Example](https://artificialanalysis.github.io/Stirrup/examples/#litellm-multi-provider-support) or [Deepseek Example](https://artificialanalysis.github.io/Stirrup/examples/#openai-compatible-apis-deepseek-vllm-ollama) for complete examples.
+
+## Default Tools
+
+When you create an `Agent` without specifying tools, it uses `DEFAULT_TOOLS`:
+
+| Tool Provider               | Tools Provided            | Description                                                  |
+| --------------------------- | ------------------------- | ------------------------------------------------------------ |
+| `LocalCodeExecToolProvider` | `code_exec`               | Execute shell commands in an isolated temp directory         |
+| `WebToolProvider`           | `web_fetch`, `web_search` | Fetch web pages and search (search requires `BRAVE_API_KEY`) |
+
+## Extending with Pre-Built Tools
+
+```python
+import asyncio
+
+from stirrup import Agent
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+from stirrup.tools import CALCULATOR_TOOL, DEFAULT_TOOLS
+
+# Create client for OpenRouter
+client = ChatCompletionsClient(
+    base_url="https://openrouter.ai/api/v1",
+    model="anthropic/claude-sonnet-4.5",
+)
+
+# Create agent with default tools + calculator tool
+agent = Agent(
+    client=client,
+    name="web_calculator_agent",
+    tools=[*DEFAULT_TOOLS, CALCULATOR_TOOL],
+)
+```
+
+## Defining Custom Tools
+
+```python
+from pydantic import BaseModel, Field
+
+from stirrup import Agent, Tool, ToolResult, ToolUseCountMetadata
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+from stirrup.tools import DEFAULT_TOOLS
+
+
+class GreetParams(BaseModel):
+    """Parameters for the greet tool."""
+
+    name: str = Field(description="Name of the person to greet")
+    formal: bool = Field(default=False, description="Use formal greeting")
+
+
+def greet(params: GreetParams) -> ToolResult[ToolUseCountMetadata]:
+    greeting = f"Good day, {params.name}." if params.formal else f"Hey {params.name}!"
+
+    return ToolResult(
+        content=greeting,
+        metadata=ToolUseCountMetadata(),
+    )
+
+
+GREET_TOOL = Tool(
+    name="greet",
+    description="Greet someone by name",
+    parameters=GreetParams,
+    executor=greet,
+)
+
+# Create client for OpenRouter
+client = ChatCompletionsClient(
+    base_url="https://openrouter.ai/api/v1",
+    model="anthropic/claude-sonnet-4.5",
+)
+
+# Add custom tool to default tools
+agent = Agent(
+    client=client,
+    name="greeting_agent",
+    tools=[*DEFAULT_TOOLS, GREET_TOOL],
+)
+```
+
+## Next Steps
+
+- [Getting Started](https://artificialanalysis.github.io/Stirrup/getting-started/) - Installation and first agent tutorial
+- [Core Concepts](https://artificialanalysis.github.io/Stirrup/concepts/) - Understand Agent, Tools, and Sessions
+- [Examples](https://artificialanalysis.github.io/Stirrup/examples/) - Working examples for common patterns
+- [Creating Tools](https://artificialanalysis.github.io/Stirrup/guides/tools/) - Build your own tools
+
+## Documentation
+
+Full documentation: [artificialanalysis.github.io/Stirrup](https://artificialanalysis.github.io/Stirrup)
+
+Build and serve locally:
+
+```bash
+uv run mkdocs serve
+```
+
+## Development
+
+```bash
+# Format and lint code
+uv run ruff format
+uv run ruff check
+
+# Type check
+uv run ty check
+
+# Run tests
+uv run pytest tests
+```
+
+## License
+
+Licensed under the [MIT LICENSE](LICENSE).

stirrup-0.1.0/README.md

@@ -0,0 +1,253 @@
+<div align="center">
+  <a href="">
+    <picture>
+        <img alt="Stirrup" src="assets/stirrup-banner.png" width="700">
+    </picture>
+  </a>
+  <br></br>
+  <h1>The lightweight foundation for building agents</h1>
+<br>
+</div>
+
+
+<p align="center">
+  <a href="https://pypi.python.org/pypi/stirrup"><img src="https://img.shields.io/pypi/v/stirrup" alt="PyPI version" /></a>&nbsp;<!--
+  --><a href="https://github.com/ArtificialAnalysis/Stirrup/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ArtificialAnalysis/Stirrup" alt="License" /></a>&nbsp;<!--
+  --><a href="https://artificialanalysis.github.io/Stirrup"><img src="https://img.shields.io/badge/MkDocs-4F46E5?logo=materialformkdocs&logoColor=fff" alt="MkDocs" /></a>
+</p>
+
+
+Stirrup is a lightweight framework, or starting point template, for building agents. It differs from other agent frameworks by:
+
+- **Working with the model, not against it:** Stirrup gets out of the way and lets the model choose its own approach to completing tasks (similar to Claude Code). Many frameworks impose rigid workflows that can degrade results.
+- **Best practices and tools built-in:** We analyzed the leading agents (Claude Code, Codex, and others) to understand and incorporate best practices relating to topics like context management and foundational tools (e.g., code execution).
+- **Fully customizable:** Use Stirrup as a package or as a starting template to build your own fully customized agents.
+
+## Features
+
+- **Essential tools built-in:**
+  - Online search / web browsing
+  - Code execution (local, Docker container, E2B sandbox)
+  - MCP client
+  - Document input and output
+- **Flexible tool execution:** A generic `Tool` class allows easy tool definition and extension
+- **Context management:** Automatically summarizes conversation history when approaching context limits
+- **Flexible provider support:** Pre-built support for OpenAI-compatible APIs and LiteLLM, or bring your own client
+- **Multimodal support:** Process images, video, and audio with automatic format conversion
+
+## Installation
+
+```bash
+# Core framework
+uv pip install stirrup      # or: uv add stirrup
+
+# With all optional components
+uv pip install stirrup[all]  # or: uv add stirrup[all]
+
+# Individual extras
+uv pip install stirrup[litellm]  # or: uv add stirrup[litellm]
+uv pip install stirrup[docker]   # or: uv add stirrup[docker]
+uv pip install stirrup[e2b]      # or: uv add stirrup[e2b]
+uv pip install stirrup[mcp]      # or: uv add stirrup[mcp]
+```
+
+## Quick Start
+
+```python
+import asyncio
+
+from stirrup import Agent
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+
+
+async def main() -> None:
+    """Run an agent that searches the web and creates a chart."""
+
+    # Create client using ChatCompletionsClient
+    # Automatically uses OPENROUTER_API_KEY environment variable
+    client = ChatCompletionsClient(
+        base_url="https://openrouter.ai/api/v1",
+        model="anthropic/claude-sonnet-4.5",
+    )
+
+    # As no tools are provided, the agent will use the default tools, which consist of:
+    # - Web tools (web search and web fetching, note web search requires BRAVE_API_KEY)
+    # - Local code execution tool (to execute shell commands)
+    agent = Agent(client=client, name="agent", max_turns=15)
+
+    # Run with session context - handles tool lifecycle, logging and file outputs
+    async with agent.session(output_dir="./output/getting_started_example") as session:
+        finish_params, history, metadata = await session.run(
+            """
+            What is the population of Australia over the last 3 years? Search the web to find out and create a
+            simple chart using matplotlib showing the current population per year."""
+        )
+
+        print("Finish params: ", finish_params)
+        print("History: ", history)
+        print("Metadata: ", metadata)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+> **Note:** This example uses OpenRouter. Set `OPENROUTER_API_KEY` in your environment before running. Web search requires a `BRAVE_API_KEY`. The agent will still work without it, but web search will be unavailable.
+
+## How It Works
+
+- **`Agent`** - Configures and runs the agent loop until a finish tool is called or max turns reached
+- **`session()`** - Context manager that sets up tools, manages files, and handles cleanup
+- **`Tool`** - Define tools with Pydantic parameters
+- **`ToolProvider`** - Manage tools that require lifecycle (connections, temp directories, etc.)
+- **`DEFAULT_TOOLS`** - Standard tools included by default: code execution and web tools
+
+## Using Other LLM Providers
+
+For non-OpenAI providers, change the base URL of the `ChatCompletionsClient`, use the `LiteLLMClient` (requires installation of optional `stirrup[litellm]` dependencies), or create your own client.
+
+### OpenAI-Compatible APIs
+
+```python
+# Create client using Deepseek's OpenAI-compatible endpoint
+client = ChatCompletionsClient(
+    base_url="https://api.deepseek.com",
+    model="deepseek-chat",  # or "deepseek-reasoner" for R1
+    api_key=os.environ["DEEPSEEK_API_KEY"],
+)
+
+agent = Agent(client=client, name="deepseek_agent")
+```
+
+### LiteLLM (Anthropic, Google, etc.)
+
+```python
+# Create LiteLLM client for Anthropic Claude
+# See https://docs.litellm.ai/docs/providers for all supported providers
+client = LiteLLMClient(
+    model_slug="anthropic/claude-sonnet-4-5",
+    max_tokens=200_000,
+)
+
+# Pass client to Agent - model info comes from client.model_slug
+agent = Agent(
+    client=client,
+    name="claude_agent",
+)
+```
+
+See [LiteLLM Example](https://artificialanalysis.github.io/Stirrup/examples/#litellm-multi-provider-support) or [Deepseek Example](https://artificialanalysis.github.io/Stirrup/examples/#openai-compatible-apis-deepseek-vllm-ollama) for complete examples.
+
+## Default Tools
+
+When you create an `Agent` without specifying tools, it uses `DEFAULT_TOOLS`:
+
+| Tool Provider               | Tools Provided            | Description                                                  |
+| --------------------------- | ------------------------- | ------------------------------------------------------------ |
+| `LocalCodeExecToolProvider` | `code_exec`               | Execute shell commands in an isolated temp directory         |
+| `WebToolProvider`           | `web_fetch`, `web_search` | Fetch web pages and search (search requires `BRAVE_API_KEY`) |
+
+## Extending with Pre-Built Tools
+
+```python
+import asyncio
+
+from stirrup import Agent
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+from stirrup.tools import CALCULATOR_TOOL, DEFAULT_TOOLS
+
+# Create client for OpenRouter
+client = ChatCompletionsClient(
+    base_url="https://openrouter.ai/api/v1",
+    model="anthropic/claude-sonnet-4.5",
+)
+
+# Create agent with default tools + calculator tool
+agent = Agent(
+    client=client,
+    name="web_calculator_agent",
+    tools=[*DEFAULT_TOOLS, CALCULATOR_TOOL],
+)
+```
+
+## Defining Custom Tools
+
+```python
+from pydantic import BaseModel, Field
+
+from stirrup import Agent, Tool, ToolResult, ToolUseCountMetadata
+from stirrup.clients.chat_completions_client import ChatCompletionsClient
+from stirrup.tools import DEFAULT_TOOLS
+
+
+class GreetParams(BaseModel):
+    """Parameters for the greet tool."""
+
+    name: str = Field(description="Name of the person to greet")
+    formal: bool = Field(default=False, description="Use formal greeting")
+
+
+def greet(params: GreetParams) -> ToolResult[ToolUseCountMetadata]:
+    greeting = f"Good day, {params.name}." if params.formal else f"Hey {params.name}!"
+
+    return ToolResult(
+        content=greeting,
+        metadata=ToolUseCountMetadata(),
+    )
+
+
+GREET_TOOL = Tool(
+    name="greet",
+    description="Greet someone by name",
+    parameters=GreetParams,
+    executor=greet,
+)
+
+# Create client for OpenRouter
+client = ChatCompletionsClient(
+    base_url="https://openrouter.ai/api/v1",
+    model="anthropic/claude-sonnet-4.5",
+)
+
+# Add custom tool to default tools
+agent = Agent(
+    client=client,
+    name="greeting_agent",
+    tools=[*DEFAULT_TOOLS, GREET_TOOL],
+)
+```
+
+## Next Steps
+
+- [Getting Started](https://artificialanalysis.github.io/Stirrup/getting-started/) - Installation and first agent tutorial
+- [Core Concepts](https://artificialanalysis.github.io/Stirrup/concepts/) - Understand Agent, Tools, and Sessions
+- [Examples](https://artificialanalysis.github.io/Stirrup/examples/) - Working examples for common patterns
+- [Creating Tools](https://artificialanalysis.github.io/Stirrup/guides/tools/) - Build your own tools
+
+## Documentation
+
+Full documentation: [artificialanalysis.github.io/Stirrup](https://artificialanalysis.github.io/Stirrup)
+
+Build and serve locally:
+
+```bash
+uv run mkdocs serve
+```
+
+## Development
+
+```bash
+# Format and lint code
+uv run ruff format
+uv run ruff check
+
+# Type check
+uv run ty check
+
+# Run tests
+uv run pytest tests
+```
+
+## License
+
+Licensed under the [MIT LICENSE](LICENSE).

stirrup-0.1.0/pyproject.toml

@@ -0,0 +1,100 @@
+[project]
+name = "stirrup"
+version = "0.1.0"
+description = "The lightweight foundation for building agents"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Artificial Analysis, Inc.", email = "info@artificialanalysis.ai" },
+
+]
+requires-python = ">=3.12"
+keywords = ["ai", "agent", "llm", "openai", "anthropic", "tools", "framework"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "anyio>=4.0.0",
+    "filetype>=1.0.0",
+    "httpx>=0.20.0",
+    "json-schema-to-pydantic>=0.2.0",
+    "moviepy>=2.0.0",
+    "openai>=1.0.0",
+    "pillow>=10.4.0",
+    "pydantic>=2.0.0",
+    "tenacity>=5.0.0",
+    "trafilatura>=1.9.0",
+]
+
+[project.optional-dependencies]
+litellm = ["litellm>=1.79.3"]
+e2b = ["e2b-code-interpreter>=2.3.0"]
+docker = ["docker>=7.0.0", "python-dotenv>=1.0.0"]
+mcp = ["mcp>=1.9.0"]
+all = ["stirrup[litellm,e2b,docker,mcp]"]
+
+[project.urls]
+Homepage = "https://github.com/ArtificialAnalysis/Stirrup"
+Documentation = "https://artificialanalysis.github.io/Stirrup"
+Repository = "https://github.com/ArtificialAnalysis/Stirrup"
+
+[build-system]
+requires = ["uv_build>=0.9.3,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "griffe-pydantic>=1.1.8",
+    "mkdocs-material>=9.7.0",
+    "mkdocstrings>=0.30.1",
+    "mkdocstrings-python>=1.19.0",
+    "pytest>=9.0.0",
+    "rich>=14.2.0",
+    "ruff>=0.14.4",
+    "ty>=0.0.1a32",
+]
+
+[tool.pytest.ini_options]
+addopts = ["--strict-markers"]
+anyio_mode = "auto"
+markers = [
+    "docker: marks tests as requiring the docker package (deselect with '-m \"not docker\"')",
+    "e2b: marks tests as requiring the e2b package (deselect with '-m \"not e2b\"')",
+]
+
+[tool.ruff]
+line-length = 120
+fix = true
+show-fixes = true
+
+[tool.ruff.lint]
+select = [
+    "F",
+    "E",
+    "W",
+    "ANN",
+    "N",
+    "B",
+    "I",
+    "ARG",
+    "SLF",
+    "UP",
+    "PERF",
+    "RUF",
+    "SIM",
+    "S113",
+    "ASYNC",
+]
+ignore = [
+    "E501",     # line too long
+    "ASYNC109", # timeout param in async fn - false positive when passing to external APIs
+]