# Toolhouse — Managed AI Tool Infrastructure

> Cloud-hosted tool execution for AI agents. Toolhouse provides 100+ pre-built tools (web search, code exec, email) with managed auth, logging, and one SDK call.

## Install

Save as a script file and run:

## Quick Use

```bash
pip install toolhouse
```

```python
from toolhouse import Toolhouse
from anthropic import Anthropic

th = Toolhouse()
client = Anthropic()

messages = [{"role": "user", "content": "Search the web for Claude Code tips"}]

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    messages=messages,
    tools=th.get_tools(),
)

# Execute tool calls
tool_results = th.run_tools(response)
```

## What is Toolhouse?

Toolhouse provides managed tool infrastructure for AI agents. Instead of building and hosting tools yourself, Toolhouse offers 100+ pre-built, cloud-hosted tools — web search, code execution, email, file operations — accessible via a single SDK call with managed authentication and logging.

**Answer-Ready**: Toolhouse is a managed AI tool infrastructure providing 100+ pre-built cloud-hosted tools (web search, code execution, email) accessible via one SDK call. Handles auth, execution, and logging so you focus on agent logic.

**Best for**: AI agent developers who want tools without infrastructure overhead. **Works with**: Anthropic, OpenAI, LangChain, Vercel AI SDK. **Setup time**: Under 2 minutes.

## Core Features

### 1. Pre-Built Tool Categories

| Category | Tools |
|----------|-------|
| Web | Search, scrape, read URL, screenshot |
| Code | Execute Python, Node.js, shell |
| Communication | Send email, Slack message |
| Data | Query databases, parse files |
| AI | Generate images, transcribe audio |
| Storage | Read/write files, manage S3 |

### 2. One-Line Integration

```python
# Anthropic
tools = th.get_tools()  # Returns tool definitions
results = th.run_tools(response)  # Executes tool calls

# OpenAI
from openai import OpenAI
client = OpenAI()
tools = th.get_tools(provider="openai")
```

### 3. Tool Bundles
Group tools by use case:

```python
# Only web tools
tools = th.get_tools(bundle="web")

# Only code execution
tools = th.get_tools(bundle="code")

# Custom selection
tools = th.get_tools(tools=["web_search", "send_email", "execute_python"])
```

### 4. Managed Execution
Tools run in Toolhouse's cloud:
- Sandboxed code execution
- Managed API keys (no credential sharing with LLMs)
- Automatic retries and error handling
- Request logging and analytics

### 5. Custom Tools

```python
@th.register_tool("my_crm_lookup")
def crm_lookup(company_name: str) -> dict:
    # Your custom logic
    return {"revenue": "10M", "employees": 50}
```

## Architecture

```
Your Agent → Anthropic/OpenAI API → Tool call response
                                         ↓
                                    Toolhouse SDK
                                         ↓
                                  Toolhouse Cloud
                                  (executes tools)
                                         ↓
                                   Tool results
                                         ↓
                                  Back to your agent
```

## FAQ

**Q: Is Toolhouse free?**
A: Free tier with 1,000 tool executions/month. Paid plans for higher volume.

**Q: Does my data pass through Toolhouse?**
A: Tool inputs/outputs pass through Toolhouse for execution. Code runs in sandboxed environments.

**Q: Can I self-host?**
A: Currently cloud-only. Self-hosting is on the roadmap.

## Source & Thanks

> Created by [Toolhouse](https://toolhouse.ai). SDK is open-source.
>
> [toolhouseai/toolhouse-sdk-python](https://github.com/toolhouseai/toolhouse-sdk-python)
> Docs: [docs.toolhouse.ai](https://docs.toolhouse.ai)

<!-- ZH -->

## 快速使用

```bash
pip install toolhouse
```

三行代码为 AI 代理添加 100+ 云端工具。

## 什么是 Toolhouse？

Toolhouse 提供托管的 AI 工具基础设施。100+ 预构建云端工具（搜索、代码执行、邮件），一个 SDK 调用即可使用。

**一句话总结**：托管 AI 工具基础设施，100+ 预构建云端工具，一行代码集成，处理认证、执行和日志。

**适合人群**：不想自建工具基础设施的 AI 代理开发者。**支持**：Anthropic、OpenAI、LangChain。

## 核心功能

### 1. 预构建工具
搜索、代码执行、邮件、文件、数据库等 100+ 工具。

### 2. 一行集成
`get_tools()` 获取工具定义，`run_tools()` 执行调用。

### 3. 工具分组
按用途分组，按需加载。

### 4. 托管执行
沙箱环境运行，自动重试和错误处理。

## 常见问题

**Q: 免费吗？**
A: 每月 1,000 次免费，付费计划更高量级。

**Q: 能自托管吗？**
A: 目前仅云端，自托管在规划中。

## 来源与致谢

> [Toolhouse](https://toolhouse.ai) — SDK 开源

---
Source: https://tokrepo.com/en/workflows/1e02143f-8872-443a-bdc0-18ffa9b60cd2
Author: Agent Toolkit