Toolbox: 56 Pre-Built Tools¶

from selectools import Agent, AgentConfig, Message, Role
from selectools.providers.stubs import LocalProvider
from selectools.toolbox import get_all_tools, get_tools_by_category

# Load all 56 pre-built tools across 19 categories
all_tools = get_all_tools()
print(f"Loaded {len(all_tools)} tools")

# Or load by category: file, web, data, datetime, text, code, search, github,
# database, calculator, email, pdf, slack, notion, linear, discord, s3,
# browser, image
text_tools = get_tools_by_category("text")
data_tools = get_tools_by_category("data")

provider = LocalProvider()
agent = Agent(
    tools=text_tools + data_tools,
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

result = agent.run([
    Message(role=Role.USER, content="Count the words in 'Hello world from selectools'")
])
print(result.content)

from selectools import Agent, AgentConfig, OpenAIProvider
from selectools.toolbox import get_all_tools

agent = Agent(
    tools=get_all_tools(),           # all 56 tools
    provider=OpenAIProvider(),
    config=AgentConfig(max_iterations=5),
)

result = agent.ask("Read the file config.json and extract the 'database.host' field")
print(result.content)

from selectools.toolbox import get_all_tools

tools = get_all_tools()  # List[Tool], 56 tools

from selectools.toolbox import get_tools_by_category

file_tools   = get_tools_by_category("file")       # 5 tools
web_tools    = get_tools_by_category("web")        # 2 tools
data_tools   = get_tools_by_category("data")       # 6 tools
dt_tools     = get_tools_by_category("datetime")   # 4 tools
text_tools   = get_tools_by_category("text")       # 7 tools
code_tools   = get_tools_by_category("code")       # 2 tools  (v0.21.0)
search_tools = get_tools_by_category("search")     # 2 tools  (v0.21.0)
gh_tools     = get_tools_by_category("github")     # 3 tools  (v0.21.0)
db_tools     = get_tools_by_category("database")   # 2 tools  (v0.21.0)
calc_tools   = get_tools_by_category("calculator") # 2 tools  (v0.23.0)
email_tools  = get_tools_by_category("email")      # 2 tools  (v0.23.0)
pdf_tools    = get_tools_by_category("pdf")        # 2 tools  (v0.23.0)
slack_tools  = get_tools_by_category("slack")      # 3 tools  (v0.23.0)
notion_tools = get_tools_by_category("notion")     # 3 tools  (v0.23.0)
linear_tools = get_tools_by_category("linear")     # 3 tools  (v0.23.0)
discord_tools = get_tools_by_category("discord")   # 2 tools  (v1.1.0)
s3_tools     = get_tools_by_category("s3")         # 3 tools  (v1.1.0)
browser_tools = get_tools_by_category("browser")   # 2 tools  (v1.1.0)
image_tools  = get_tools_by_category("image")      # 1 tool   (v1.1.0)

from selectools.toolbox.file_tools import read_file, write_file
from selectools.toolbox.web_tools import http_get
from selectools.toolbox.data_tools import parse_json, json_to_csv
from selectools.toolbox.text_tools import extract_emails, convert_case
from selectools.toolbox.datetime_tools import get_current_time
from selectools.toolbox.code_tools import execute_python, execute_shell       # v0.21.0
from selectools.toolbox.search_tools import web_search, scrape_url            # v0.21.0
from selectools.toolbox.github_tools import github_search_repos, github_get_file  # v0.21.0
from selectools.toolbox.db_tools import query_sqlite, query_postgres          # v0.21.0
from selectools.toolbox.calculator_tools import evaluate_expression, unit_convert  # v0.23.0
from selectools.toolbox.email_tools import send_email, read_inbox             # v0.23.0
from selectools.toolbox.pdf_tools import extract_pdf_text, extract_pdf_tables  # v0.23.0
from selectools.toolbox.slack_tools import slack_send_message, slack_read_channel  # v0.23.0
from selectools.toolbox.notion_tools import notion_create_page, notion_search  # v0.23.0
from selectools.toolbox.linear_tools import linear_create_issue, linear_list_issues  # v0.23.0
from selectools.toolbox.discord_tools import discord_send_message, discord_read_channel  # v1.1.0
from selectools.toolbox.s3_tools import s3_list_objects, s3_get_object, s3_put_object  # v1.1.0
from selectools.toolbox.browser_tools import browser_scrape_page, browser_screenshot  # v1.1.0
from selectools.toolbox.image_tools import generate_image                     # v1.1.0

from selectools.toolbox import get_tools_by_category

agent = Agent(
    tools=get_tools_by_category("file"),
    provider=provider,
    config=AgentConfig(max_iterations=5),
)

agent.ask("Write 'Hello World' to output.txt, then read it back")
agent.ask("List all .py files in the src/ directory recursively")

agent = Agent(
    tools=get_tools_by_category("web"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Fetch https://api.github.com/repos/python/cpython")
agent.ask("POST to https://httpbin.org/post with data {\"name\": \"test\"}")

agent = Agent(
    tools=get_tools_by_category("data"),
    provider=provider,
    config=AgentConfig(max_iterations=5),
)

agent.ask('Parse this JSON and convert to CSV: [{"name":"Alice","age":30},{"name":"Bob","age":25}]')
agent.ask('Extract the "items.0.price" field from {"items":[{"price":9.99}]}')

agent = Agent(
    tools=get_tools_by_category("datetime"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("What's the current time in America/New_York?")
agent.ask("How many days between 2026-01-01 and 2026-12-31?")
agent.ask("What date is 90 days from 2026-03-12?")

agent = Agent(
    tools=get_tools_by_category("text"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Extract all emails and URLs from: 'Contact support@example.com at https://example.com'")
agent.ask("Convert 'hello world example' to camelCase")
agent.ask("Count the words in this paragraph: ...")

agent = Agent(
    tools=get_tools_by_category("code"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Run this Python code: print('Hello from subprocess!')")

agent = Agent(
    tools=get_tools_by_category("search"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Search for 'Python async programming best practices'")
agent.ask("Scrape the text from https://example.com")

agent = Agent(
    tools=get_tools_by_category("github"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Search GitHub for 'machine learning language:python'")
agent.ask("Get the README from johnnichev/selectools")
agent.ask("List open issues in johnnichev/selectools")

agent = Agent(
    tools=get_tools_by_category("db"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Query the database at ./app.db: SELECT name, email FROM users LIMIT 5")

agent = Agent(
    tools=get_tools_by_category("calculator"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("What is sqrt(2) * 10 ** 3?")
agent.ask("Convert 26.2 miles to km and 98.6 F to C")

agent = Agent(
    tools=get_tools_by_category("email"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Email a status summary to team@example.com")
agent.ask("Summarize my 5 most recent emails")

agent = Agent(
    tools=get_tools_by_category("pdf"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Extract the tables from invoice.pdf pages 1-2 and total the amounts")

agent = Agent(
    tools=get_tools_by_category("slack"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Post 'deploy finished' to #releases")
agent.ask("Summarize the last 20 messages in C0123456789")

agent = Agent(
    tools=get_tools_by_category("notion"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Find my 'Roadmap' page and add a child page titled 'Q3 Plan'")

agent = Agent(
    tools=get_tools_by_category("linear"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("List my open issues and create a follow-up issue for the flaky test")

agent = Agent(
    tools=get_tools_by_category("discord"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Post 'v1.1.0 released' to channel 123456789012345678")
agent.ask("Summarize the last 20 messages in channel 123456789012345678")

agent = Agent(
    tools=get_tools_by_category("s3"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("List the objects under reports/ in the analytics bucket and summarize the latest CSV")

agent = Agent(
    tools=get_tools_by_category("browser"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Scrape https://example.com and summarize the page")
agent.ask("Take a full-page screenshot of https://example.com and save it to shots/home.png")

agent = Agent(
    tools=get_tools_by_category("image"),
    provider=provider,
    config=AgentConfig(max_iterations=3),
)

agent.ask("Generate a watercolor fox illustration and save it to assets/fox.png")

from selectools import tool
from selectools.toolbox import get_tools_by_category

@tool(description="Query our internal database")
def query_db(sql: str) -> str:
    # your custom implementation
    return "results..."

agent = Agent(
    tools=[query_db] + get_tools_by_category("data") + get_tools_by_category("text"),
    provider=provider,
    config=AgentConfig(max_iterations=5),
)