harelba/q

q - Run SQL directly on delimited files and multi-file sqlite databases

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 10 minutes ago
Added to GitGenius on September 5th, 2026
Created on January 30th, 2012
Open Issues & Pull Requests: 131 (+0)
GitHub issues: Enabled
Number of forks: 424
Total Stargazers: 10,363 (+0)
Total Subscribers: 157 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 5.9 hours
Mean response time: 41.3 days
90th percentile: 222.4 days
Tracked items: 7

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 17
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 1,102 days
Stale 30+ days: 16
Stale 90+ days: 16

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

No label distribution available yet.

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

q is a command-line tool that lets you run SQL queries directly on delimited text files and SQLite databases without importing data into a separate database first.

The tool solves the problem of querying structured text data using SQL without the overhead of loading files into a database engine. It works by treating delimited files as tables that can be queried with standard SQL syntax. You can query CSV, TSV, and other delimited formats, as well as work with existing SQLite databases. The approach allows you to combine multiple files and databases in a single query, making it useful for ad-hoc analysis and data exploration workflows.

q is best suited for developers and data analysts who need quick SQL access to text files without setting up infrastructure. It works well for one-off queries, exploratory data analysis, and situations where you have structured data in files but want SQL's power without database setup overhead. The tool is particularly valuable when you need to join data across multiple files or combine file-based data with existing SQLite databases.

The project shows consistent maintenance with regular updates addressing bugs and user-reported issues. Development includes active engagement with user feedback, incorporating feature requests and fixing edge cases in file parsing and SQL execution. The codebase receives improvements to performance and compatibility with different delimited formats. Testing coverage is maintained across the tool's core functionality to ensure reliability in query execution and file handling.