tooluniverse-sdk

name

tooluniverse-sdk

description

Build AI scientist systems with the ToolUniverse Python SDK for scientific research. Covers the 3 calling patterns (`tu.run` portable dict API, `tu.tools.X` function API, direct class instantiation), tool loading, batch execution, MCP server integration, and embedding-based tool search. Use for SDK programming, custom tool composition, benchmarking pipelines, and integrating ToolUniverse into research workflows.

ToolUniverse Python SDK

3 calling patterns -- start with pattern 1:

1. tu.run({"name": ..., "arguments": ...}) -- single tool call, dict API (most portable)
2. tu.tools.ToolName(param=value) -- function API (recommended for interactive use)
3. Direct class instantiation -- advanced, bypasses caching/hooks

Installation

pip install tooluniverse              # Standard
pip install tooluniverse[embedding]   # Embedding search (GPU)
pip install tooluniverse[all]         # All features

export OPENAI_API_KEY="sk-..."  # Required for LLM tool search
export NCBI_API_KEY="..."       # Optional

Quick Start

from tooluniverse import ToolUniverse

tu = ToolUniverse()
tu.load_tools()  # REQUIRED before any tool call

# Find tools
tools = tu.run({"name": "Tool_Finder_Keyword", : {: , : }})


result = tu.run({: , : {: }})


result = tu.tools.UniProt_get_entry_by_accession(accession=)