termask-ai 1.0.0__tar.gz

termask_ai-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Istiak Ahmmed Soyeb
+
+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.

termask_ai-1.0.0/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: termask-ai
+Version: 1.0.0
+Summary: A lightweight CLI wrapper for Google Gemini & OpenAI — built for Termux and Linux terminals.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/estiaksoyeb/termai
+Project-URL: Repository, https://github.com/estiaksoyeb/termai
+Project-URL: Bug Tracker, https://github.com/estiaksoyeb/termai/issues
+Keywords: ai,cli,gemini,openai,terminal,termux,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: license-file
+
+## Termai
+Termai is a lightweight, zero-dependency CLI wrapper for Google's Gemini AI, built for Termux on Android and general Linux environments.
+It brings the power of Large Language Models (LLMs) directly to your command line, following the Unix philosophy of piping and standard streams.
+
+## Features
+* **Lightweight:** Uses standard Python requests. No heavy SDKs or complex dependencies.
+* **Unix Compatible:** Supports piping (stdin). Feed logs, code, or text files directly into the AI.
+* **Configurable:** Built-in JSON configuration system (ai --config) to edit System Prompts, Temperature, and Models.
+* **Fast:** Defaults to gemini-2.5-flash for instant responses.
+* **Clean UI:** Minimalist output with syntax-highlighted green text.
+
+## Installation
+
+You can install Termai as a global Python package using `pipx` (recommended for isolated environments like Termux) or standard `pip`.
+
+```bash
+# Using pipx (recommended)
+pipx install termask-ai
+
+# Or using pip
+pip install termask-ai
+```
+
+After installation, the global commands `ai` and `termai` will be available in your terminal.
+
+## Setup
+On the very first run, Termai will ask for your Google Gemini API Key.
+* Get a free API key here: Google AI Studio
+* Run the command:
+```bash
+ai "hello"
+```
+
+* Paste your key when prompted. It will be saved locally.
+
+## Usage
+1. Basic Questions
+Ask anything directly from the terminal.
+```bash
+ai "How do I untar a file in Linux?"
+```
+
+2. Piping (The Power Move)
+Feed output from other commands into Termai.
+Debug an error log:
+```bash
+cat error.log | ai "Explain what caused this crash"
+```
+
+Explain a file:
+```bash
+cat README.md | ai "Summarize this project in one sentence"
+```
+
+Generate code and save it:
+```bash
+ai "Write a Python hello world script" > hello.py
+```
+
+3. Saving Outputs (With Terminal Output)
+You can save the response to a file while still viewing the output in your terminal:
+```bash
+# Save a single-query response
+ai "Explain machine learning in 1 sentence" -o ml_concept.txt
+
+# Automatically save a chat session transcript when you exit
+ai chat -o chat_session.md
+```
+
+4. Interactive Chat
+Start an interactive, multi-turn chat session with memory:
+```bash
+ai chat
+```
+* **Rich Terminal Aesthetics**: Interactive chat features a beautiful slate-blue header card and full-width royal-purple highlight blocks for user messages (properly aligned even when emojis are used).
+* **Conversation Snapshots**: Save your chat transcript in clean Markdown format at any point during the conversation by typing:
+  ```text
+  save snapshot.md
+  ```
+
+## Profile Management
+Termai supports multiple AI provider configurations. You can manage them using the `profile` subcommand:
+
+* **List profiles**:
+  ```bash
+  ai profile
+  ```
+  *(Alias: `ai profile list`)*
+* **Switch default active profile**:
+  ```bash
+  ai profile use [profile_name]
+  ```
+  *(Launches an interactive selection list if no profile name is provided)*
+* **Add a new profile**:
+  ```bash
+  ai profile add <name>
+  ```
+* **Remove a profile**:
+  ```bash
+  ai profile remove <name>
+  ```
+  *(Alias: `ai profile rm`)*
+* **Run query with temporary profile**:
+  ```bash
+  ai -p <profile_name> "your query"
+  ```
+
+## Configuration
+Termai comes with a built-in configuration editor. You can change the AI provider, model, and personality.
+Run:
+```bash
+ai --config
+```
+
+This opens `config.json` in your preferred editor. The editor is chosen based on the following priority:
+1. The `$EDITOR` environment variable.
+2. `vim` (if installed).
+3. `nano` (as a fallback).
+
+The configuration file looks like this:
+```json
+{
+    "provider": "gemini",
+    "proxy": "http://user:pass@127.0.0.1:1080",
+    "gemini_config": {
+        "api_key": "YOUR_GEMINI_KEY",
+        "model_name": "gemini-2.5-flash",
+        "system_instruction": "You are a CLI assistant for Termux...",
+        "generation_config": {
+            "temperature": 0.7,
+            "maxOutputTokens": 1024
+        }
+    },
+    "openai_config": {
+        "api_key": "YOUR_OPENAI_KEY",
+        "model_name": "gpt-4o",
+        "system_instruction": "You are a helpful assistant.",
+        "temperature": 0.7,
+        "max_tokens": 1024
+    }
+}
+```
+
+* **`provider`**: Set to `"gemini"` or `"openai"` to choose your AI provider.
+* **`proxy`**: (Optional) Set an HTTP or HTTPS proxy for all requests.
+* **`gemini_config`**: Settings for when `provider` is `"gemini"`.
+  * `model_name`: Change to `gemini-2.5-pro` or other available models.
+  * `system_instruction`: Give the AI a persona.
+  * `temperature`: Set to `1.0` for creative answers, `0.1` for precise logic.
+* **`openai_config`**: Settings for when `provider` is `"openai"`.
+  * `model_name`: Change to `gpt-3.5-turbo`, etc.
+  * `system_instruction`: A different persona for ChatGPT.
+  * `temperature`: Controls randomness.
+  * `max_tokens`: The maximum number of tokens to generate.
+
+## Shell Auto-Completion
+Termai includes built-in dynamic shell autocompletion for subcommands, options, profile names, and models.
+
+To enable shell auto-completion, add one of the following commands to your shell profile file (like `~/.bashrc` or `~/.zshrc`):
+
+* **Bash** (add to `~/.bashrc`):
+  ```bash
+  source <(ai completion bash)
+  ```
+* **Zsh** (add to `~/.zshrc`):
+  ```zsh
+  source <(ai completion zsh)
+  ```
+
+## Help & Troubleshooting
+**Command List:**
+```bash
+ai --help
+```
+
+**Re-configure API Keys:**
+
+To reset and re-enter your API keys, use the `--reinstall` flag.
+```bash
+ai --reinstall
+```
+
+**Debug Mode:**
+
+If the AI isn't responding or you are getting errors, run:
+```bash
+ai --debug "your question"
+```
+This will print the raw server response and error codes.
+
+**Debug Configuration:**
+If you are having issues with your configuration, you can use the `--debug-config` flag to print the loaded configuration. API keys will be redacted for security.
+```bash
+ai --debug-config
+```
+
+## Uninstallation
+To remove Termai completely:
+
+```bash
+# If installed via pipx
+pipx uninstall termask-ai
+
+# If installed via pip
+pip uninstall termask-ai
+
+# Optional: Remove configuration files
+rm -rf ~/.config/termai
+rm -rf ~/.local/share/termai
+```
+
+## License
+This project is licensed under the MIT License.
+You are free to use, modify, and distribute this software. See the LICENSE file for more details.
+
+<p align="center">
+Made for CLI enthusiasts
+</p>

termask_ai-1.0.0/README.md

@@ -0,0 +1,218 @@
+## Termai
+Termai is a lightweight, zero-dependency CLI wrapper for Google's Gemini AI, built for Termux on Android and general Linux environments.
+It brings the power of Large Language Models (LLMs) directly to your command line, following the Unix philosophy of piping and standard streams.
+
+## Features
+* **Lightweight:** Uses standard Python requests. No heavy SDKs or complex dependencies.
+* **Unix Compatible:** Supports piping (stdin). Feed logs, code, or text files directly into the AI.
+* **Configurable:** Built-in JSON configuration system (ai --config) to edit System Prompts, Temperature, and Models.
+* **Fast:** Defaults to gemini-2.5-flash for instant responses.
+* **Clean UI:** Minimalist output with syntax-highlighted green text.
+
+## Installation
+
+You can install Termai as a global Python package using `pipx` (recommended for isolated environments like Termux) or standard `pip`.
+
+```bash
+# Using pipx (recommended)
+pipx install termask-ai
+
+# Or using pip
+pip install termask-ai
+```
+
+After installation, the global commands `ai` and `termai` will be available in your terminal.
+
+## Setup
+On the very first run, Termai will ask for your Google Gemini API Key.
+* Get a free API key here: Google AI Studio
+* Run the command:
+```bash
+ai "hello"
+```
+
+* Paste your key when prompted. It will be saved locally.
+
+## Usage
+1. Basic Questions
+Ask anything directly from the terminal.
+```bash
+ai "How do I untar a file in Linux?"
+```
+
+2. Piping (The Power Move)
+Feed output from other commands into Termai.
+Debug an error log:
+```bash
+cat error.log | ai "Explain what caused this crash"
+```
+
+Explain a file:
+```bash
+cat README.md | ai "Summarize this project in one sentence"
+```
+
+Generate code and save it:
+```bash
+ai "Write a Python hello world script" > hello.py
+```
+
+3. Saving Outputs (With Terminal Output)
+You can save the response to a file while still viewing the output in your terminal:
+```bash
+# Save a single-query response
+ai "Explain machine learning in 1 sentence" -o ml_concept.txt
+
+# Automatically save a chat session transcript when you exit
+ai chat -o chat_session.md
+```
+
+4. Interactive Chat
+Start an interactive, multi-turn chat session with memory:
+```bash
+ai chat
+```
+* **Rich Terminal Aesthetics**: Interactive chat features a beautiful slate-blue header card and full-width royal-purple highlight blocks for user messages (properly aligned even when emojis are used).
+* **Conversation Snapshots**: Save your chat transcript in clean Markdown format at any point during the conversation by typing:
+  ```text
+  save snapshot.md
+  ```
+
+## Profile Management
+Termai supports multiple AI provider configurations. You can manage them using the `profile` subcommand:
+
+* **List profiles**:
+  ```bash
+  ai profile
+  ```
+  *(Alias: `ai profile list`)*
+* **Switch default active profile**:
+  ```bash
+  ai profile use [profile_name]
+  ```
+  *(Launches an interactive selection list if no profile name is provided)*
+* **Add a new profile**:
+  ```bash
+  ai profile add <name>
+  ```
+* **Remove a profile**:
+  ```bash
+  ai profile remove <name>
+  ```
+  *(Alias: `ai profile rm`)*
+* **Run query with temporary profile**:
+  ```bash
+  ai -p <profile_name> "your query"
+  ```
+
+## Configuration
+Termai comes with a built-in configuration editor. You can change the AI provider, model, and personality.
+Run:
+```bash
+ai --config
+```
+
+This opens `config.json` in your preferred editor. The editor is chosen based on the following priority:
+1. The `$EDITOR` environment variable.
+2. `vim` (if installed).
+3. `nano` (as a fallback).
+
+The configuration file looks like this:
+```json
+{
+    "provider": "gemini",
+    "proxy": "http://user:pass@127.0.0.1:1080",
+    "gemini_config": {
+        "api_key": "YOUR_GEMINI_KEY",
+        "model_name": "gemini-2.5-flash",
+        "system_instruction": "You are a CLI assistant for Termux...",
+        "generation_config": {
+            "temperature": 0.7,
+            "maxOutputTokens": 1024
+        }
+    },
+    "openai_config": {
+        "api_key": "YOUR_OPENAI_KEY",
+        "model_name": "gpt-4o",
+        "system_instruction": "You are a helpful assistant.",
+        "temperature": 0.7,
+        "max_tokens": 1024
+    }
+}
+```
+
+* **`provider`**: Set to `"gemini"` or `"openai"` to choose your AI provider.
+* **`proxy`**: (Optional) Set an HTTP or HTTPS proxy for all requests.
+* **`gemini_config`**: Settings for when `provider` is `"gemini"`.
+  * `model_name`: Change to `gemini-2.5-pro` or other available models.
+  * `system_instruction`: Give the AI a persona.
+  * `temperature`: Set to `1.0` for creative answers, `0.1` for precise logic.
+* **`openai_config`**: Settings for when `provider` is `"openai"`.
+  * `model_name`: Change to `gpt-3.5-turbo`, etc.
+  * `system_instruction`: A different persona for ChatGPT.
+  * `temperature`: Controls randomness.
+  * `max_tokens`: The maximum number of tokens to generate.
+
+## Shell Auto-Completion
+Termai includes built-in dynamic shell autocompletion for subcommands, options, profile names, and models.
+
+To enable shell auto-completion, add one of the following commands to your shell profile file (like `~/.bashrc` or `~/.zshrc`):
+
+* **Bash** (add to `~/.bashrc`):
+  ```bash
+  source <(ai completion bash)
+  ```
+* **Zsh** (add to `~/.zshrc`):
+  ```zsh
+  source <(ai completion zsh)
+  ```
+
+## Help & Troubleshooting
+**Command List:**
+```bash
+ai --help
+```
+
+**Re-configure API Keys:**
+
+To reset and re-enter your API keys, use the `--reinstall` flag.
+```bash
+ai --reinstall
+```
+
+**Debug Mode:**
+
+If the AI isn't responding or you are getting errors, run:
+```bash
+ai --debug "your question"
+```
+This will print the raw server response and error codes.
+
+**Debug Configuration:**
+If you are having issues with your configuration, you can use the `--debug-config` flag to print the loaded configuration. API keys will be redacted for security.
+```bash
+ai --debug-config
+```
+
+## Uninstallation
+To remove Termai completely:
+
+```bash
+# If installed via pipx
+pipx uninstall termask-ai
+
+# If installed via pip
+pip uninstall termask-ai
+
+# Optional: Remove configuration files
+rm -rf ~/.config/termai
+rm -rf ~/.local/share/termai
+```
+
+## License
+This project is licensed under the MIT License.
+You are free to use, modify, and distribute this software. See the LICENSE file for more details.
+
+<p align="center">
+Made for CLI enthusiasts
+</p>

termask_ai-1.0.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "termask-ai"
+version = "1.0.0"
+description = "A lightweight CLI wrapper for Google Gemini & OpenAI — built for Termux and Linux terminals."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.7"
+dependencies = [
+    "requests",
+]
+keywords = ["ai", "cli", "gemini", "openai", "terminal", "termux", "llm"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/estiaksoyeb/termai"
+Repository = "https://github.com/estiaksoyeb/termai"
+"Bug Tracker" = "https://github.com/estiaksoyeb/termai/issues"
+
+[project.scripts]
+ai = "termai_pkg:main"
+termai = "termai_pkg:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["termai_pkg*"]

termask_ai-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+