basic-open-agent-tools
An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
Installation
pip install basic-open-agent-tools
Or with UV:
uv add basic-open-agent-tools
Optional Dependencies
pip install basic-open-agent-tools[all] # Everything
pip install basic-open-agent-tools[system] # Process management, system info
pip install basic-open-agent-tools[pdf] # PDF reading and creation
pip install basic-open-agent-tools[xml] # XML parsing and validation
pip install basic-open-agent-tools[word] # Word document operations
pip install basic-open-agent-tools[excel] # Excel spreadsheet operations
pip install basic-open-agent-tools[powerpoint] # PowerPoint presentations
pip install basic-open-agent-tools[image] # Image processing
pip install basic-open-agent-tools[data] # YAML and TOML support
Quick Start
import basic_open_agent_tools as boat
# Essential tools for general-purpose agents (~23 tools)
tools = boat.load_essential()
# Pre-configured loadouts for specific roles
tools = boat.load_coder_loadout() # ~105 tools for development
tools = boat.load_docs_loadout() # ~130 tools for documentation
tools = boat.load_data_analyst_loadout() # ~115 tools for data analysis
tools = boat.load_web_publisher_loadout() # ~90 tools for web content
tools = boat.load_visual_designer_loadout() # ~60 tools for graphics
tools = boat.load_office_suite_loadout() # ~80 tools for Office work
# Or load everything
tools = boat.load_all_tools() # All 337 functions
# Use with any agent framework
from google.adk.agents import Agent
agent = Agent(tools=boat.load_coder_loadout())
Available Modules
21 modules with 337 total functions — all with @strands_tool decorator and Google ADK compatible signatures.
| Module | Count | Description |
|---|---|---|
| Core Operations | ||
file_system |
19 | File/directory operations, tree generation |
text |
10 | Text processing, case conversion, formatting |
data |
23 | JSON, CSV, YAML, TOML processing and validation |
datetime |
46 | Date/time operations, timezones, formatting, parsing |
| Document Processing | ||
excel |
24 | Spreadsheet reading, writing, formatting, charts |
xml |
24 | XML parsing, authoring, validation, transformation |
pdf |
20 | PDF creation, reading, manipulation |
word |
18 | Word document operations and formatting |
html |
17 | HTML generation and parsing |
diagrams |
16 | Mermaid and PlantUML diagram generation |
markdown |
17 | Markdown generation, parsing, HTML conversion |
powerpoint |
10 | PowerPoint presentation operations |
| System & Network | ||
system |
19 | Shell commands, process management, environment |
network |
4 | HTTP client, DNS lookup, port checking |
utilities |
8 | Debugging, timing, performance tools |
| Security & Data | ||
crypto |
14 | Hashing, encoding, UUID/token generation |
color |
14 | Color conversion, palette generation, analysis |
image |
12 | Image manipulation and metadata reading |
archive |
9 | ZIP, TAR, GZIP, BZIP2, XZ compression |
| Task Management | ||
todo |
8 | Task creation, validation, management |
logging |
5 | Structured logging and log rotation |
Key Features
- Agent-Friendly — Simplified type signatures prevent "signature too complex" errors
- Minimal Dependencies — Pure Python core; optional deps only when needed
- Modular — Load only what you need
- Multi-Framework — Works with Google ADK, LangChain, Strands Agents, custom frameworks
- Smart Confirmations — Write/delete operations adapt to interactive, agent, or automation contexts
- Pre-configured Loadouts — 6 curated tool bundles optimized for specific use cases
Loadouts
Choose the right loadout for your agent's role to minimize token usage and maximize relevance:
| Loadout | Tools | Best For | Includes |
|---|---|---|---|
load_coder_loadout() |
~105 | Dev, DevOps, automation | File system, system ops, network, logging, crypto, archive, configs |
load_docs_loadout() |
~130 | Technical writing, reports | Word, PDF, Markdown, HTML, diagrams, images, text |
load_data_analyst_loadout() |
~115 | Data/financial analysis, BI | Excel, CSV, validation, diagrams, JSON, YAML, XML |
load_web_publisher_loadout() |
~90 | Web dev, content management | HTML, XML, Markdown, network, text processing |
load_visual_designer_loadout() |
~60 | Graphics, infographics | Image processing, diagrams, color tools |
load_office_suite_loadout() |
~80 | Office productivity | Excel, Word, PowerPoint, file operations |
Tool Loaders
Beyond loadouts, build custom tool sets by combining loaders:
import basic_open_agent_tools as boat
# Use-case focused loaders
boat.load_essential() # ~23 most commonly needed tools
boat.load_core_readonly() # 28 read-only tools (filesystem, text, data parsing)
boat.load_converters() # 78 pure transformation tools (text, datetime, crypto, color)
boat.load_document_readers() # Extract content from PDF, Word, Excel, PowerPoint, images
boat.load_writers() # All file creation/modification tools
boat.load_analyst_tools() # Data analysis and validation tools
boat.load_web_tools() # HTML, Markdown, network operations
boat.load_devtools() # Debugging, logging, performance measurement
boat.load_structured_data_tools() # CSV, JSON, XML, YAML, TOML, INI
boat.load_office_suite() # Excel, Word, PowerPoint tools
boat.load_markup_tools() # HTML, Markdown, XML processing
# Per-module loaders (21 total — one for each module)
boat.load_all_filesystem_tools()
boat.load_all_text_tools()
boat.load_all_data_tools()
# ... etc.
# Combine and deduplicate
custom = boat.merge_tool_lists(
boat.load_all_filesystem_tools(),
boat.load_all_text_tools(),
boat.load_all_data_tools(),
)
# Inspect available tools
boat.list_all_available_tools() # List all tool names
boat.get_tool_info(some_tool) # Get tool metadata
Safety Features
All write/delete operations include a skip_confirm parameter with three modes:
| Mode | When | Behavior |
|---|---|---|
| Bypass | skip_confirm=True or BYPASS_TOOL_CONSENT=true env var |
Proceeds immediately — for CI/CD and automation |
| Interactive | Terminal with skip_confirm=False |
Prompts user with y/n and preview info |
| Agent | Non-TTY with skip_confirm=False |
Raises CONFIRMATION_REQUIRED error; LLM can ask user and retry |
# Safe by default — adapts to context
boat.file_system.write_file_from_string(
file_path="/tmp/example.txt",
content="Hello, World!",
skip_confirm=False # Interactive prompt OR agent error
)
# Explicit bypass
boat.file_system.write_file_from_string(
file_path="/tmp/example.txt",
content="Updated content",
skip_confirm=True
)
Documentation
- Getting Started — Installation and setup
- API Reference — Complete function reference
- Examples — Usage examples and patterns
- FAQ — Troubleshooting and common questions
- Contributing — Development guidelines
- Changelog — Version history
Contributing
We welcome contributions! See our Contributing Guide for development setup, coding standards, and pull request process.
License
MIT License — see LICENSE for details.
Metadata
Release files for basic-open-agent-tools 1.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| basic_open_agent_tools-1.3.2.tar.gz | 198.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| basic_open_agent_tools-1.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 435.0 kB
Release files / basic_open_agent_tools-1.3.2.tar.gz
| Download URL | basic_open_agent_tools-1.3.2.tar.gz |
|---|---|
| Size | 198.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0649f5bc579c5eb8456549df23cd58ca22e6848deaa6bae126343e98f394c5ba
|
|
BLAKE2b-256 checksum How to use checksums |
2f727b8f353fd8696b169d0bf286dc080d85f2981a867a40c23559d0a4f2167f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2026.
Transparency logRelease files / basic_open_agent_tools-1.3.2-py3-none-any.whl
| Download URL | basic_open_agent_tools-1.3.2-py3-none-any.whl |
|---|---|
| Size | 236.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
084ed9f23e48d21d5fc62d2ede68b4669f030b6da850f0fa414eab8fedcd3015
|
|
BLAKE2b-256 checksum How to use checksums |
35fb37a7b41f5f470bbab971edb5ed2c98f31478cc5fca8827d4f9ae06871af9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 11, 2026.
Transparency log
