Skip to content

Release v1.0.0: First Stable Release 🎉

Choose a tag to compare

View all tags
@jwesleye jwesleye released this 21 Oct 15:39
· 41 commits to main since this release
v1.0.0
b3b6c58

🎉 Basic Open Agent Tools v1.0.0 - First Stable Release

This is the first stable release of basic-open-agent-tools, marking a significant milestone in providing foundational tools for AI agents.

📦 What's Included

Complete Modules (20)

  • ✅ Archive - Compression and archive operations
  • ✅ Color - Color manipulation and analysis
  • ✅ Crypto - Cryptographic utilities
  • ✅ Data - JSON, CSV, YAML, TOML, INI processing
  • ✅ Datetime - Comprehensive date/time utilities
  • ✅ Diagrams - Mermaid and PlantUML generation
  • ✅ Excel - Spreadsheet reading, writing, formatting
  • ✅ File System - File and directory operations
  • ✅ HTML - HTML parsing and generation
  • ✅ Image - Image processing and manipulation
  • ✅ Logging - Structured logging with rotation
  • ✅ Markdown - Markdown parsing and generation
  • ✅ Network - Network utilities and validation
  • ✅ PDF - PDF creation, reading, manipulation
  • ✅ PowerPoint - Presentation creation and reading
  • ✅ System - System information and operations
  • ✅ Text - Text processing and manipulation
  • ✅ TODO - Task management with persistence
  • ✅ Utilities - Configuration and timing utilities
  • ✅ Word - Document creation, reading, styling
  • ✅ XML - XML parsing, authoring, validation

Statistics

  • 326 foundational tools for AI agents
  • 74% test coverage with 1378 passing tests
  • 100% code quality (ruff + mypy compliance)
  • Full Google ADK compatibility
  • Strands Agents integration

🚀 New in 1.0.0

Task Persistence (v0.15.1)

  • save_tasks_to_file() - Save tasks to JSON with atomic writes
  • load_tasks_from_file() - Load tasks with 3 merge strategies (replace, merge, merge_renumber)
  • validate_task_file() - Comprehensive file validation
  • Dependency remapping for renumbered tasks
  • Circular dependency detection
  • Structured logging for visibility

Structured Logging (v0.15.0)

  • Added comprehensive logging to all todo operations
  • Agents can see task operations even without verbalization
  • [TODO] prefix for easy filtering

🎯 API Stability

With v1.0.0, we commit to:

  • Semantic versioning - No breaking changes in 1.x
  • Stable API - Functions won't change signatures
  • Backward compatibility - Safe to upgrade within 1.x

📚 Installation

pip install basic-open-agent-tools

Optional Dependencies

pip install basic-open-agent-tools[all]  # All features
pip install basic-open-agent-tools[pdf]  # PDF support
pip install basic-open-agent-tools[excel]  # Excel support
# ... and more (see README)

🤖 Agent Framework Support

Compatible with:

  • Google ADK - Direct function imports
  • LangChain - StructuredTool wrapping
  • Strands Agents - Native @strands_tool decorator
  • Custom Agents - Simple function imports

🔗 Quick Start

import basic_open_agent_tools as boat

# Load all tools for your agent
tools = boat.load_all_tools()

# Or load specific categories
fs_tools = boat.load_all_filesystem_tools()
data_tools = boat.load_all_data_tools()

📖 Documentation

🛣️ What's Next

Planned for 1.1.0+

  • Text template processing (high priority)
  • TODO export to multiple formats
  • Enhanced datetime formatting
  • Excel charts and conditional formatting
  • PDF form support and image extraction

See our GitHub Issues for the full roadmap.

🙏 Acknowledgments

Built for the AI agent community with a focus on:

  • Minimal dependencies - Prefer stdlib
  • Google ADK compliance - Agent-first design
  • Quality - Comprehensive testing and typing
  • Safety - User confirmation for destructive operations

Full Changelog: v0.15.1...v1.0.0

🤖 Generated with Claude Code

Assets 2
Loading