Github url


by harelba

harelba /q

q - Run SQL directly on CSV or TSV files

7.5K Stars 340 Forks Last release: 6 months ago (2.0.9) GNU General Public License v3.0 343 Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Build Status

q - Text as Data

q is a command line tool that allows direct execution of SQL-like queries on CSVs/TSVs (and any other tabular text files).

q treats ordinary files as database tables, and supports all SQL constructs, such as






s, etc. It supports automatic column name and type detection, and q provides full support for multiple character encodings.

q's web site is It contains everything you need to download and use q immediately.


Extremely simple.

Instructions for all OSs are here.


q "SELECT COUNT(\*) FROM ./clicks\_file.csv WHERE c3 \> 32.3" ps -ef | q -H "SELECT UID, COUNT(\*) cnt FROM - GROUP BY UID ORDER BY cnt DESC LIMIT 3"

Go here for more examples.

Python API

A development branch for exposing q's capabilities as a Python module can be viewed here, along with examples of the alpha version of the API.
Existing functionality as a command-line tool will not be affected by this. Your input will be most appreciated.


Any feedback/suggestions/complaints regarding this tool would be much appreciated. Contributions are most welcome as well, of course.

Linkedin: Harel Ben Attia

Twitter @harelba

Email [email protected]

q on twitter: #qtextasdata

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.