Skip to main content

​
Overview

CSV tool allows you to read, write, and query CSV files. The user points to a CSV file; the agent reads, filters, or writes rows and returns the result.

​
Installation

pip install "praisonai[tools]"

​
Quick Start

1

Simple Usage

from praisonai_tools import CSVTool

# Initialize
csv_tool = CSVTool()

# Read CSV
data = csv_tool.read("data.csv")
print(data)
2

With Configuration

Use the same tool with an agent — see Usage with Agent below, or pass env vars and options from the sections above.

​
Usage with Agent

from praisonaiagents import Agent
from praisonai_tools import CSVTool

agent = Agent(
    name="DataAnalyst",
    instructions="You help analyze CSV data.",
    tools=[CSVTool()]
)

response = agent.chat("Read sales.csv and summarize the data")
print(response)

​
Available Methods

​
read(path)

Read a CSV file. 
from praisonai_tools import CSVTool

csv_tool = CSVTool()
data = csv_tool.read("data.csv")

​
write(path, data)

Write data to a CSV file. 
csv_tool.write("output.csv", [{"name": "Alice", "age": 30}])

​
How It Works

​
Best Practices

Inspect column names before querying so the agent references real fields, not guesses.
For big CSVs, process in chunks so memory stays bounded.
Confirm row shape before write so you don’t corrupt an existing file.

JSON

JSON files

Pandas

Data analysis

File

General files