Ai Agent Tools

# AI Agent Tools - Python Utility Library for AI Agents

## 📖 Overview

This library provides ready-to-use Python functions that AI agents can leverage to perform various tasks including file operations, text analysis, data transformation, memory management, and validation.

## ⚡ Quick Start

### Installation

#### Method 1: Clone from GitHub
```bash
git clone https://github.com/cerbug45/ai-agent-tools.git
cd ai-agent-tools
```

#### Method 2: Direct Download
```bash
wget https://raw.githubusercontent.com/cerbug45/ai-agent-tools/main/ai_agent_tools.py
```

#### Method 3: Copy-Paste
Simply copy the `ai_agent_tools.py` file into your project directory.

### Requirements
- Python 3.7 or higher
- No external dependencies (uses only standard library)

## 🛠️ Available Tools

### 1. FileTools - File Operations

Operations for reading, writing, and managing files.

**Available Methods:**

```python
from ai_agent_tools import FileTools

# Read a file
content = FileTools.read_file("path/to/file.txt")

# Write to a file
FileTools.write_file("path/to/file.txt", "Hello World!")

# List files in directory
files = FileTools.list_files(".", extension=".py")

# Check if file exists
exists = FileTools.file_exists("path/to/file.txt")
```

**Use Cases:**
- Reading configuration files
- Saving agent outputs
- Listing available resources
- Checking file existence before operations

---

### 2. TextTools - Text Processing

Extract information and process text data.

**Available Methods:**

```python
from ai_agent_tools import TextTools

text = "Contact: john@example.com, phone: 0532 123 45 67"

# Extract emails
emails = TextTools.extract_emails(text)
# Output: ['john@example.com']

# Extract URLs
urls = TextTools.extract_urls("Visit https://example.com")
# Output: ['https://example.com']

# Extract phone numbers
phones = TextTools.extract_phone_numbers(text)
# Output: ['0532 123 45 67']

# Count words
count = TextTools.word_count("Hello world from AI")
# Output: 4

# Summarize text
summ...

# 🤖 AI Agent Tools

[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub Issues](https://img.shields.io/github/issues/cerbug45/ai-agent-tools.svg)](https://github.com/cerbug45/ai-agent-tools/issues)

A comprehensive Python utility library designed for AI agents. Provides ready-to-use tools for file operations, text processing, data transformation, memory management, and validation.

## ✨ Features

- 🗂️ **File Operations** - Read, write, list, and check files
- 📝 **Text Processing** - Extract emails, URLs, phone numbers; clean and summarize text
- 🔄 **Data Transformation** - Convert between JSON, CSV, and dictionary formats
- 🧰 **Utilities** - Timestamps, ID generation, calculations
- 💾 **Memory Management** - Store and retrieve data during execution
- ✅ **Validation** - Validate emails, URLs, and phone numbers

## 🚀 Quick Start

### Installation

```bash
# Clone the repository
git clone https://github.com/cerbug45/ai-agent-tools.git
cd ai-agent-tools

# Or just download the file
wget https://raw.githubusercontent.com/cerbug45/ai-agent-tools/main/ai_agent_tools.py
```

### Basic Usage

```python
from ai_agent_tools import FileTools, TextTools, DataTools

# Read a file
content = FileTools.read_file("data.txt")

# Extract emails
emails = TextTools.extract_emails(content)

# Save as JSON
DataTools.save_json({"emails": emails}, "output.json")
```

## 📖 Documentation

For full documentation, see [SKILL.md](SKILL.md)

### Available Tool Categories

| Category | Description | Key Functions |
|----------|-------------|---------------|
| **FileTools** | File operations | `read_file`, `write_file`, `list_files` |
| **TextTools** | Text processing | `extract_emails`, `extract_urls`, `word_count` |
| **DataTools** | Data conversion | `save_json`, `load_json`, `csv_to_dict` |
| **UtilityTools** | Gene...