Local File System

What is the Local File System tool?

The Local File System tool is a built-in capability in the Agno framework that allows AI agents to write files to local file system with directory management. When added to an agent in Agno Builder, the agent can autonomously decide when to invoke this tool based on the user's request.

This is a free tool — no API key or external account is needed. It works out of the box when you add it to any agent.

How to use Local File System in Agno Builder

1. 1

   Create an agent

   Drag an Agent node onto the canvas in Agno Builder, or use one of the built-in templates.

2. 2

   Enable Local File System

   Click the agent, go to the Tools tab, and toggle on "Local File System" from the core category.

3. 3

   Test in chat

   Open the chat panel and send a message. The agent will automatically use Local File System when relevant.

4. 4

   Export Python code

   Click File > Export Python to get clean, runnable code with the correct imports for Local File System.

Python code example

This is the code Agno Builder exports when you use Local File System:

from agno.agent import Agent
from agno.models.openai import OpenAIChat
from agno.tools.local_file_system import LocalFileSystemTools

agent = Agent(
    name="Local File System Agent",
    model=OpenAIChat(id="gpt-4o"),
    tools=[LocalFileSystemTools()],
    instructions=["Use the local file system tool to help the user."],
    markdown=True,
)

agent.print_response("Help me with a local-file-system task")

Install with: pip install agno