cq - High-Performance SQL Query Engine for CSV Files

A lightweight, fast SQL query processor written in C that enables executing SQL queries directly on CSV files without requiring a database. For full documentation, see the /doc directory.

Documentation

• Getting Started: doc/GettingStarted.md
• Installation: doc/Installation.md
• Command Line Interface: doc/CLI.md
• TUI (Terminal User Interface): doc/TUI.md
• Architecture: doc/Architecture.md
• Testing: doc/Testing.md
• Roadmap: doc/Roadmap.md
• Contributing: doc/Contributing.md

Quick Start

Build: make

Command Line

Run a sample query: ./build/cq -q "SELECT name, age FROM 'data.csv' WHERE age > 25" -p

Terminal UI

Launch interactive TUI: ./build/cqtui data/

Features:

• Browse and open CSV files as tables
• Execute SQL queries interactively
• Multi-tab interface for multiple tables
• Keyboard-driven navigation
• No external dependencies

Example SQL Files

The repository includes example SQL files under assets/ (example_between.sql, example_aggregation.sql, etc.). See assets/ for details.

Data & Features Overview

• See the /doc folder for detailed sections on data types, date formats, CSV format, and more.

License

MIT License. See LICENSE file for details.

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-08 ---