querymind-cli 0.1.0__tar.gz

querymind_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siddhesh Shankar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

querymind_cli-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: querymind-cli
+Version: 0.1.0
+Summary: CLI AI Data Analyst — query CSV and Excel files in plain English
+Author-email: Siddhesh <siddhesh.codemaster.github@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/SiddheshCodeMaster/QueryMind
+Project-URL: Repository, https://github.com/SiddheshCodeMaster/QueryMind
+Project-URL: Bug Tracker, https://github.com/SiddheshCodeMaster/QueryMind/issues
+Keywords: data analysis,cli,natural language,csv,excel,pandas,llm,ollama,terminal,data analytics
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: textual>=0.47
+Requires-Dist: requests>=2.31
+Requires-Dist: chardet>=5.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: xlrd>=2.0
+Dynamic: license-file
+
+# 🧠 QueryMind
+
+**Ask questions about your data in plain English. No SQL. No code. Just a terminal.**
+
+QueryMind is a CLI data analyst that lets you load a CSV or Excel file and query it conversationally — right in your terminal.
+
+```
+>> top 5 regions by sales
+>> which month had the highest profit?
+>> average spend by payment method in ascending order
+>> show sales in sheet Orders by customer segment
+```
+
+---
+
+## Install
+
+```bash
+pip install querymind-cli
+```
+
+**Requirements:**
+- Python 3.10+
+- [Ollama](https://ollama.ai) (optional — enables LLM fallback for complex queries)
+
+If you want LLM support, install Ollama and pull the model:
+```bash
+ollama pull phi
+```
+
+---
+
+## Quickstart
+
+```bash
+querymind
+```
+
+You'll be prompted to:
+1. Enter a CSV or Excel file path
+2. Select sheets (Excel only)
+3. Map your metric and dimension columns
+4. Start asking questions
+
+---
+
+## What it can do
+
+| Query | What happens |
+|---|---|
+| `top 5 products by revenue` | Ranked bar chart in terminal |
+| `which region had lowest sales` | Ascending comparison with insight |
+| `average profit by category` | Mean aggregation per group |
+| `sales trend over time monthly` | Monthly groupby on datetime column |
+| `show sales in sheet Orders by region` | Sheet-scoped query |
+| `which manager had the most sales` | Cross-sheet join (Orders + Users) |
+| `sales by region in ascending order` | Explicit sort order |
+
+---
+
+## Supported file formats
+
+| Format | Extension |
+|---|---|
+| CSV | `.csv`, `.tsv` |
+| Excel | `.xlsx`, `.xls`, `.xlsm` |
+
+Auto-detects: encoding (UTF-8 BOM, latin-1), delimiter (comma, semicolon, tab, pipe), packed integer dates (DDMMYYYY, YYYYMMDD).
+
+---
+
+## How it works
+
+```
+Your query
+    ↓
+InputGuard       — blocks gibberish and sensitive input
+    ↓
+InterpreterAgent — rule-based intent extraction (fast, no LLM needed)
+    ↓
+LLMInterpreter   — Ollama fallback for complex queries (optional)
+    ↓
+JoinResolver     — auto-detects and performs cross-sheet joins
+    ↓
+Analyzer         — pandas groupby / aggregation
+    ↓
+InsightGenerator — formats result + ASCII bar chart
+```
+
+---
+
+## Beta
+
+QueryMind is in active development. If something breaks or a query gives a wrong answer, please [open an issue](https://github.com/SiddheshCodeMaster/QueryMind/issues) with:
+- Your query
+- The column names in your file (no need to share actual data)
+- The output you got
+
+This feedback directly shapes what gets fixed next.
+
+---
+
+## License
+
+MIT

querymind_cli-0.1.0/README.md

@@ -0,0 +1,105 @@
+# 🧠 QueryMind
+
+**Ask questions about your data in plain English. No SQL. No code. Just a terminal.**
+
+QueryMind is a CLI data analyst that lets you load a CSV or Excel file and query it conversationally — right in your terminal.
+
+```
+>> top 5 regions by sales
+>> which month had the highest profit?
+>> average spend by payment method in ascending order
+>> show sales in sheet Orders by customer segment
+```
+
+---
+
+## Install
+
+```bash
+pip install querymind-cli
+```
+
+**Requirements:**
+- Python 3.10+
+- [Ollama](https://ollama.ai) (optional — enables LLM fallback for complex queries)
+
+If you want LLM support, install Ollama and pull the model:
+```bash
+ollama pull phi
+```
+
+---
+
+## Quickstart
+
+```bash
+querymind
+```
+
+You'll be prompted to:
+1. Enter a CSV or Excel file path
+2. Select sheets (Excel only)
+3. Map your metric and dimension columns
+4. Start asking questions
+
+---
+
+## What it can do
+
+| Query | What happens |
+|---|---|
+| `top 5 products by revenue` | Ranked bar chart in terminal |
+| `which region had lowest sales` | Ascending comparison with insight |
+| `average profit by category` | Mean aggregation per group |
+| `sales trend over time monthly` | Monthly groupby on datetime column |
+| `show sales in sheet Orders by region` | Sheet-scoped query |
+| `which manager had the most sales` | Cross-sheet join (Orders + Users) |
+| `sales by region in ascending order` | Explicit sort order |
+
+---
+
+## Supported file formats
+
+| Format | Extension |
+|---|---|
+| CSV | `.csv`, `.tsv` |
+| Excel | `.xlsx`, `.xls`, `.xlsm` |
+
+Auto-detects: encoding (UTF-8 BOM, latin-1), delimiter (comma, semicolon, tab, pipe), packed integer dates (DDMMYYYY, YYYYMMDD).
+
+---
+
+## How it works
+
+```
+Your query
+    ↓
+InputGuard       — blocks gibberish and sensitive input
+    ↓
+InterpreterAgent — rule-based intent extraction (fast, no LLM needed)
+    ↓
+LLMInterpreter   — Ollama fallback for complex queries (optional)
+    ↓
+JoinResolver     — auto-detects and performs cross-sheet joins
+    ↓
+Analyzer         — pandas groupby / aggregation
+    ↓
+InsightGenerator — formats result + ASCII bar chart
+```
+
+---
+
+## Beta
+
+QueryMind is in active development. If something breaks or a query gives a wrong answer, please [open an issue](https://github.com/SiddheshCodeMaster/QueryMind/issues) with:
+- Your query
+- The column names in your file (no need to share actual data)
+- The output you got
+
+This feedback directly shapes what gets fixed next.
+
+---
+
+## License
+
+MIT