Local File System

LocalFileSystemTools enables agents to write files to the local file system with automatic directory management.

Example

The following agent can write content to local files:

from agno.agent import Agent
from agno.tools.local_file_system import LocalFileSystemTools

agent = Agent(
    instructions=[
        "You are a file management assistant that helps save content to local files",
        "Create files with appropriate names and extensions",
        "Organize files in the specified directory structure",
        "Provide clear feedback about file operations",
    ],
    tools=[LocalFileSystemTools(target_directory="./output")],
)

agent.print_response("Save this meeting summary to a file: 'Discussed Q4 goals and budget allocation'", stream=True)

Toolkit Params

Parameter	Type	Default	Description
target_directory	Optional[str]	None	Default directory to write files to. Uses current directory.
default_extension	str	"txt"	Default file extension to use if none specified.
enable_write_file	bool	True	Enable file writing functionality.

Toolkit Functions

Function	Description
write_file	Write content to a local file with customizable options.

Developer Resources

• View Tools Source
• Python pathlib Documentation
• File I/O Best Practices