Skip to main content

Overview

File tool allows you to read, write, and manage files from your AI agents.

Installation

pip install "praisonai[tools]"

Quick Start

from praisonai_tools import FileTool

# Initialize
file = FileTool()

# Read file
content = file.read("document.txt")
print(content)

Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import FileTool

agent = Agent(
    name="FileManager",
    instructions="You help manage files.",
    tools=[FileTool()]
)

response = agent.chat("Read the contents of config.json")
print(response)

Available Methods

read(path)

Read file contents.
from praisonai_tools import FileTool

file = FileTool()
content = file.read("data.txt")

write(path, content)

Write content to a file.
file.write("output.txt", "Hello World!")

list_dir(path)

List directory contents.
files = file.list_dir("./documents")

Common Errors

ErrorCauseSolution
File not foundInvalid pathCheck file path
Permission deniedNo accessCheck permissions