Local File System

Prerequisites

Create and activate a virtual environment, then install:

uv pip install agno openai

The Agent model uses an OpenAI key, separately from any toolkit provider credentials.

Set OpenAI Key

Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.

export OPENAI_API_KEY=sk-***

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 for file operations. Uses the current directory if not set. Created if it doesn't exist.
`default_extension`	`str`	`"txt"`	Default file extension to use if none specified.
`enable_write_file`	`bool`	`True`	Enable the `write_file` tool.
`enable_read_file`	`bool`	`True`	Enable the `read_file` tool.
`restrict_to_base_dir`	`bool`	`True`	If True, file operations cannot escape `target_directory`.
`all`	`bool`	`False`	Enables all functionality when set to True.

Toolkit Functions

Function	Description
`write_file`	Write content to a local file with customizable options.
`read_file`	Read content from a local file.