Parrot: Talk to Your Data 🦜

Parrot is a terminal-based RAG + Agentic AI tool that lets you interact with your data sources using natural language. Query CSV files, PostgreSQL databases, and more—right from your terminal.

Screenshots

🚀 Features

✅ Ask questions in natural language – No SQL or scripting required
✅ Interactive CLI experience – Simple and intuitive
✅ Rich output formatting – Get well-structured responses
✅ Export Chat – Export your chats to different formats like csv, JSON or text.

🔧 Installation

Requirements

• Python 3.8+
• uv (Recommended for dependency management)
• LLM API Key (OpenAI, Claude, Groq)

Steps

1. Clone the repository:

   git clone https://github.com/your-repo/parrot.git
   cd parrot

2. Create a virtual environment using uv:

   uv venv

3. Install dependencies:

   uv sync   # Or use `pip install -r requirements.txt`

🛠 Usage

Run in Interactive Mode

Start a session to chat with your data:

uv run main.py

or

python main.py

---

📂 Supported Data Sources

✅ PostgreSQL
✅ CSV Files
🚧 Coming Soon: MySQL, Parquet, Avro, DOCX, XLSX, PDF, TXT, JSON