termux-ai 0.2.0__tar.gz

termux_ai-0.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Istiak Ahmmed Soyeb
+Copyright (c) 2026 attajak (https://github.com/attajak)
+
+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.

termux_ai-0.2.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: termux-ai
+Version: 0.2.0
+Summary: A lightweight CLI tool for AI integration in your terminal.
+Author-email: estiaksoyeb <estiakahamed122@gmail.com>, attajak <janrak@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Istiak Ahmmed Soyeb
+        Copyright (c) 2026 attajak (https://github.com/attajak)
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/attajak/termai
+Project-URL: Bug Reports, https://github.com/attajak/termai/issues
+Project-URL: Funding, https://paypal.me/attajak
+Project-URL: Source, https://github.com/attajak/termai
+Keywords: termai,termux-ai,cli,ai,termux
+Requires-Python: >=3.8
+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.
+ * **🧹 Auto-Cleanup:** The installer sets everything up and deletes the repository to save space.
+
+## 📥 Installation
+### Method 1: Global Install (Recommended)
+You can install Termai directly using `pip` or `pipx`:
+```bash
+# Using pip
+pip install .
+
+# Using pipx (cleanest)
+pipx install .
+```
+This will make the `ai` command available globally.
+
+### Method 2: Manual Setup (for Development)
+If you want to contribute or run Termai in a development environment:
+## 🔑 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.
+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 script:
+```bash
+cat install.sh | ai "What does this script do?"
+```
+
+Generate code and save it:
+```bash
+ai "Write a Python hello world script" > hello.py
+```
+
+## ⚙️ 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.
+
+## 🛠 Development
+If you want to contribute or run Termai in a development environment:
+
+1.  **Clone and set up a virtual environment:**
+    ```bash
+    git clone https://github.com/estiaksoyeb/termai
+    cd termai
+    python -m venv .venv
+    source .venv/bin/activate
+    ```
+
+2.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+3.  **Run in development mode:**
+    ```bash
+    pip install -e .
+    # Now the 'ai' command will use your local development version.
+    ```
+
+## ❓ 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
+### If installed via pip/pipx:
+```bash
+pip uninstall termai
+# or
+pipx uninstall 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 with ❤️ for CLI enthusiasts
+</p>

termux_ai-0.2.0/README.md

@@ -0,0 +1,168 @@
+## 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.
+ * **🧹 Auto-Cleanup:** The installer sets everything up and deletes the repository to save space.
+
+## 📥 Installation
+### Method 1: Global Install (Recommended)
+You can install Termai directly using `pip` or `pipx`:
+```bash
+# Using pip
+pip install .
+
+# Using pipx (cleanest)
+pipx install .
+```
+This will make the `ai` command available globally.
+
+### Method 2: Manual Setup (for Development)
+If you want to contribute or run Termai in a development environment:
+## 🔑 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.
+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 script:
+```bash
+cat install.sh | ai "What does this script do?"
+```
+
+Generate code and save it:
+```bash
+ai "Write a Python hello world script" > hello.py
+```
+
+## ⚙️ 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.
+
+## 🛠 Development
+If you want to contribute or run Termai in a development environment:
+
+1.  **Clone and set up a virtual environment:**
+    ```bash
+    git clone https://github.com/estiaksoyeb/termai
+    cd termai
+    python -m venv .venv
+    source .venv/bin/activate
+    ```
+
+2.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+3.  **Run in development mode:**
+    ```bash
+    pip install -e .
+    # Now the 'ai' command will use your local development version.
+    ```
+
+## ❓ 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
+### If installed via pip/pipx:
+```bash
+pip uninstall termai
+# or
+pipx uninstall 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 with ❤️ for CLI enthusiasts
+</p>

termux_ai-0.2.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "termux-ai"
+version = "0.2.0"
+description = "A lightweight CLI tool for AI integration in your terminal."
+keywords = ["termai", "termux-ai", "cli", "ai", "termux"]
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [
+  {name = "estiaksoyeb", email = "estiakahamed122@gmail.com"},
+  {name = "attajak", email = "janrak@gmail.com"},
+]
+requires-python = ">=3.8"
+dependencies = [
+    "requests",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/attajak/termai"
+"Bug Reports" = "https://github.com/attajak/termai/issues"
+"Funding" = "https://paypal.me/attajak"
+"Source" = "https://github.com/attajak/termai"
+
+[project.scripts]
+ai = "termai.cli:main"

termux_ai-0.2.0/setup.cfg

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

termux_ai-0.2.0/termai/__init__.py

@@ -0,0 +1 @@
+# Termai package initialization

termux_ai-0.2.0/termai/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

termux_ai-0.2.0/termai/api.py

@@ -0,0 +1,24 @@
+from .providers.gemini import GeminiProvider
+from .providers.openai import OpenAIProvider
+
+PROVIDERS = {
+    "gemini": GeminiProvider(),
+    "openai": OpenAIProvider()
+}
+
+def send_request(config, user_input, debug_mode):
+    provider_name = config.get("provider", "gemini")
+    provider = PROVIDERS.get(provider_name)
+    
+    if not provider:
+        print(f"[Error] Provider '{provider_name}' is not supported.")
+        return 1
+        
+    return provider.send_request(config, user_input, debug_mode)
+
+# Keep these for backward compatibility if needed in other parts of the code
+def send_gemini_request(config, user_input, debug_mode):
+    return GeminiProvider().send_request(config, user_input, debug_mode)
+
+def send_openai_request(config, user_input, debug_mode):
+    return OpenAIProvider().send_request(config, user_input, debug_mode)

termux_ai-0.2.0/termai/cli.py

@@ -0,0 +1,65 @@
+import sys
+import json
+import copy
+from .constants import APP_NAME, CONFIG_FILE
+from .config import load_config, open_editor
+from .api import send_request
+from .ui import print_help
+
+def cli_entry_point():
+    # Handle --reinstall flag first
+    if "--reinstall" in sys.argv:
+        if CONFIG_FILE.exists():
+            print(f"[{APP_NAME}] Deleting existing config for reinstall...")
+            CONFIG_FILE.unlink()
+        else:
+            print(f"[{APP_NAME}] No existing config found. Starting first-time setup...")
+    
+    config = load_config()
+    
+    if "--reinstall" in sys.argv:
+        print(f"[{APP_NAME}] Reinstall complete.")
+        return 0
+
+    # Handle --debug-config flag
+    if "--debug-config" in sys.argv:
+        if not config:
+            print("[Error] No configuration file found. Run `ai --reinstall` to create one.")
+            return 1
+        
+        debug_config = copy.deepcopy(config)
+        if "gemini_config" in debug_config and "api_key" in debug_config["gemini_config"]:
+            key = debug_config["gemini_config"]["api_key"]
+            debug_config["gemini_config"]["api_key"] = f"***{key[-4:]}" if key else ""
+        if "openai_config" in debug_config and "api_key" in debug_config["openai_config"]:
+            key = debug_config["openai_config"]["api_key"]
+            debug_config["openai_config"]["api_key"] = f"***{key[-4:]}" if key else ""
+            
+        print(json.dumps(debug_config, indent=4))
+        return 0
+
+    if config is None and not sys.stdin.isatty():
+        return 1
+    
+    if "--help" in sys.argv or "-h" in sys.argv:
+        return print_help()
+
+    if "--config" in sys.argv:
+        return open_editor()
+
+    debug_mode = "--debug" in sys.argv
+    args = [arg for arg in sys.argv[1:] if arg not in ["--debug", "--config", "--help", "-h", "--reinstall", "--debug-config"]]
+
+    user_input = ""
+    if not sys.stdin.isatty():
+        user_input = sys.stdin.read().strip()
+        if args: user_input += "\n" + " ".join(args)
+    elif args:
+        user_input = " ".join(args)
+    else:
+        return print_help()
+
+    return send_request(config, user_input, debug_mode)
+
+def main():
+    sys.exit(cli_entry_point())

termux_ai-0.2.0/termai/config.py

@@ -0,0 +1,151 @@
+import os
+import sys
+import json
+import subprocess
+import copy
+import shutil
+from .constants import APP_NAME, DATA_DIR, CONFIG_FILE, OLD_KEY_FILE
+
+# --- Default Settings ---
+DEFAULT_CONFIG = {
+    "provider": "gemini",
+    "proxy": "",
+    "gemini_config": {
+        "api_key": "",
+        "model_name": "gemini-2.5-flash",
+        "system_instruction": "You are a CLI assistant for command-line users. Do NOT use Markdown. Do NOT use backticks. Do NOT use bolding. Just write plain text. Keep answers concise.",
+        "generation_config": {
+            "temperature": 0.7,
+            "top_p": 0.9,
+            "top_k": 40,
+            "maxOutputTokens": 1024
+        }
+    },
+    "openai_config": {
+        "api_key": "",
+        "model_name": "gpt-4o",
+        "system_instruction": "You are a CLI assistant for command-line users. Do NOT use Markdown. Do NOT use backticks. Do NOT use bolding. Just write plain text. Keep answers concise.",
+        "temperature": 0.7,
+        "max_tokens": 1024
+    }
+}
+
+def load_config():
+    """
+    Loads config.json. 
+    Handles migration from old 'key' file and old flat config structure if needed.
+    Creates default file if missing.
+    """
+    # Ensure directory exists
+    if not DATA_DIR.exists():
+        DATA_DIR.mkdir(parents=True, exist_ok=True)
+
+    config = {}
+    # 1. Check for Config File
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                config = json.load(f)
+        except json.JSONDecodeError:
+            print(f"[Error] Your config file ({CONFIG_FILE}) is invalid JSON.")
+            print("Please fix it or delete it to reset defaults.")
+            sys.exit(1)
+
+        # Migration from old flat structure to new nested structure
+        if "api_key" in config:
+            print(f"[{APP_NAME}] Migrating config to new nested structure...")
+            new_config = copy.deepcopy(DEFAULT_CONFIG)
+            # Preserve old top-level keys
+            new_config["proxy"] = config.get("proxy", "")
+            
+            # Move gemini-specific keys
+            new_config["gemini_config"]["api_key"] = config.get("api_key", "")
+            new_config["gemini_config"]["model_name"] = config.get("model_name", DEFAULT_CONFIG["gemini_config"]["model_name"])
+            new_config["gemini_config"]["system_instruction"] = config.get("system_instruction", DEFAULT_CONFIG["gemini_config"]["system_instruction"])
+            new_config["gemini_config"]["generation_config"] = config.get("generation_config", DEFAULT_CONFIG["gemini_config"]["generation_config"])
+            
+            with open(CONFIG_FILE, "w") as f:
+                json.dump(new_config, f, indent=4)
+            print("Migration complete.")
+            return new_config
+
+        return config
+
+    # If no config file exists, proceed with first run setup
+    # 2. Migration: If no config, check for old key file
+    gemini_api_key = ""
+    backup_file = DATA_DIR / "key.bak"
+    if OLD_KEY_FILE.exists():
+        print(f"[{APP_NAME}] Migrating legacy key file to new config format...")
+        with open(OLD_KEY_FILE, "r") as f:
+            gemini_api_key = f.read().strip()
+        OLD_KEY_FILE.rename(backup_file)
+        
+    # 3. First Run Setup
+    new_config = copy.deepcopy(DEFAULT_CONFIG)
+    if sys.stdin.isatty():
+        print(f"[{APP_NAME}] First run! Choose your primary AI provider.")
+        provider = ""
+        while provider not in ["1", "2"]:
+            provider = input("Enter 1 for Gemini or 2 for OpenAI: ").strip()
+
+        if provider == "1":
+            new_config["provider"] = "gemini"
+            if not gemini_api_key:
+                print(f"[{APP_NAME}] Enter your Gemini API Key. Get it from aistudio.google.com")
+                gemini_api_key = input("Gemini API Key: ").strip()
+                if not gemini_api_key:
+                    print("Error: Gemini key cannot be empty.")
+                    sys.exit(1)
+            new_config["gemini_config"]["api_key"] = gemini_api_key
+        
+        elif provider == "2":
+            new_config["provider"] = "openai"
+            print(f"[{APP_NAME}] Enter your OpenAI API Key. Get it from platform.openai.com")
+            openai_api_key = input("OpenAI API Key: ").strip()
+            if not openai_api_key:
+                print("Error: OpenAI key cannot be empty.")
+                sys.exit(1)
+            new_config["openai_config"]["api_key"] = openai_api_key
+    else:
+        # Default to Gemini if non-interactive and no config exists
+        # This part might need adjustment based on desired non-interactive behavior
+        if not gemini_api_key:
+             return None # Cannot proceed without an API key
+        new_config["gemini_config"]["api_key"] = gemini_api_key
+
+    # Save the new configuration
+    with open(CONFIG_FILE, "w") as f:
+        json.dump(new_config, f, indent=4)
+    
+    print(f"Configuration saved to {CONFIG_FILE}\n")
+
+    # Clean up the legacy key backup file if it exists after migration
+    if backup_file.exists():
+         backup_file.unlink()
+
+    return new_config
+
+def open_editor():
+    """
+    Opens the config file in the user's preferred editor with a fallback mechanism.
+    Priority: $EDITOR > vim > nano
+    """
+    # 1. Prioritize the user's explicit choice
+    editor = os.getenv('EDITOR')
+
+    # 2. If no $EDITOR, try to find 'vim'
+    if not editor and shutil.which('vim'):
+        editor = 'vim'
+    
+    # 3. If still no editor, fall back to 'nano'
+    if not editor:
+        editor = 'nano'
+
+    print(f"Opening config in {editor}...")
+    try:
+        subprocess.call([editor, str(CONFIG_FILE)])
+    except FileNotFoundError:
+        print(f"[Error] Editor '{editor}' not found. Please install it or set the $EDITOR environment variable.")
+        return 1
+    return 0 # Return 0 for success

termux_ai-0.2.0/termai/constants.py

@@ -0,0 +1,15 @@
+from pathlib import Path
+
+# --- Configuration Paths ---
+APP_NAME = "termai"
+DATA_DIR = Path.home() / ".local/share" / APP_NAME
+# We now use a JSON file for all settings
+CONFIG_FILE = DATA_DIR / "config.json"
+# Legacy file path for migration
+OLD_KEY_FILE = DATA_DIR / "key"
+
+# --- Colors ---
+GREEN = "\033[92m"
+CYAN = "\033[96m"
+YELLOW = "\033[93m"
+RESET = "\033[0m"

termux_ai-0.2.0/termai/providers/base.py

@@ -0,0 +1,7 @@
+from abc import ABC, abstractmethod
+
+class BaseProvider(ABC):
+    @abstractmethod
+    def send_request(self, config, user_input, debug_mode):
+        """Send a request to the AI model."""
+        pass

termux_ai-0.2.0/termai/providers/gemini.py

@@ -0,0 +1,50 @@
+import requests
+from ..constants import GREEN, RESET
+from .base import BaseProvider
+
+class GeminiProvider(BaseProvider):
+    def send_request(self, config, user_input, debug_mode):
+        gemini_config = config.get("gemini_config", {})
+        api_key = gemini_config.get("api_key")
+        model_name = gemini_config.get("model_name", "gemini-2.5-flash")
+        system_instr = gemini_config.get("system_instruction", "")
+        gen_config = gemini_config.get("generation_config", {})
+        proxy = config.get("proxy", "")
+        api_url = f"https://generativelanguage.googleapis.com/v1beta/models/{model_name}:generateContent?key={api_key}"
+        payload = {
+            "contents": [{"parts": [{"text": user_input}]}],
+            "systemInstruction": {"parts": [{"text": system_instr}]},
+            "generationConfig": gen_config
+        }
+        if debug_mode: print(f"[Debug] Provider: Gemini | Model: {model_name} | Temp: {gen_config.get('temperature')} | Proxy: {proxy if proxy else 'None'}")
+        try:
+            proxies = {"http": proxy, "https": proxy} if proxy else None
+            response = requests.post(api_url, json=payload, proxies=proxies)
+            if debug_mode:
+                print(f"[Debug] Status: {response.status_code}")
+            if response.status_code != 200:
+                if response.status_code == 429:
+                    print(f"\n[Error 429] You have exceeded your Gemini API quota.")
+                    print("Please check your usage and billing details at aistudio.google.com.")
+                else:
+                    print(f"\n[Error {response.status_code}]")
+                    print(response.text)
+                return 1
+            data = response.json()
+            if "promptFeedback" in data and "blockReason" in data["promptFeedback"]:
+                print(f"[Blocked] Reason: {data['promptFeedback']['blockReason']}")
+                return 0
+            if "candidates" in data and data["candidates"]:
+                cand = data["candidates"][0]
+                if "content" in cand and "parts" in cand["content"] and cand["content"]["parts"]:
+                    print(f"{GREEN}{cand['content']['parts'][0]['text'].strip()}{RESET}")
+                else:
+                    print("[No content returned]")
+                    if debug_mode: print(data)
+            else:
+                print("[Error] Invalid response format from Gemini")
+                if debug_mode: print(data)
+            return 0
+        except Exception as e:
+            print(f"\n[Connection Error] {e}")
+            return 1

termux_ai-0.2.0/termai/providers/openai.py

@@ -0,0 +1,57 @@
+import requests
+from ..constants import GREEN, RESET
+from .base import BaseProvider
+
+class OpenAIProvider(BaseProvider):
+    def send_request(self, config, user_input, debug_mode):
+        openai_config = config.get("openai_config", {})
+        api_key = openai_config.get("api_key")
+        model_name = openai_config.get("model_name", "gpt-4o")
+        system_instr = openai_config.get("system_instruction", "")
+        temperature = openai_config.get("temperature", 0.7)
+        max_tokens = openai_config.get("max_tokens", 1024)
+        proxy = config.get("proxy", "")
+        api_url = "https://api.openai.com/v1/chat/completions"
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {api_key}"
+        }
+        payload = {
+            "model": model_name,
+            "messages": [
+                {"role": "system", "content": system_instr},
+                {"role": "user", "content": user_input}
+            ],
+            "temperature": temperature,
+            "max_tokens": max_tokens
+        }
+        if debug_mode: print(f"[Debug] Provider: OpenAI | Model: {model_name} | Temp: {temperature} | Proxy: {proxy if proxy else 'None'}")
+        try:
+            proxies = {"http": proxy, "https": proxy} if proxy else None
+            response = requests.post(api_url, headers=headers, json=payload, proxies=proxies)
+            if debug_mode:
+                print(f"[Debug] Status: {response.status_code}")
+            if response.status_code != 200:
+                if response.status_code == 429:
+                    print(f"\n[Error 429] You have exceeded your OpenAI API quota.")
+                    print("Please check your usage and billing details at platform.openai.com.")
+                else:
+                    print(f"\n[Error {response.status_code}]")
+                    print(response.text)
+                return 1
+            data = response.json()
+            if "choices" in data and data["choices"]:
+                message = data["choices"][0].get("message", {})
+                content = message.get("content", "")
+                if content:
+                    print(f"{GREEN}{content.strip()}{RESET}")
+                else:
+                    print("[No content returned]")
+                    if debug_mode: print(data)
+            else:
+                print("[Error] Invalid response format from OpenAI")
+                if debug_mode: print(data)
+            return 0
+        except Exception as e:
+            print(f"\n[Connection Error] {e}")
+            return 1

termux_ai-0.2.0/termai/ui.py

@@ -0,0 +1,23 @@
+from .constants import GREEN, CYAN, YELLOW, RESET
+
+def print_help():
+    """Prints the help menu with available commands."""
+    print(f"\n{GREEN}Termai - A CLI AI Assistant{RESET}")
+    print(f"A lightweight CLI tool for AI integration in your terminal.\n")
+    
+    print(f"{YELLOW}Usage:{RESET}")
+    print(f"  ai [OPTIONS] \"YOUR QUERY\"")
+    print(f"  cat file.txt | ai [OPTIONS] \"OPTIONAL PROMPT\"")
+    
+    print(f"\n{YELLOW}Options:{RESET}")
+    print(f"  {CYAN}--config{RESET}        Open configuration file")
+    print(f"  {CYAN}--debug{RESET}         Enable debug mode")
+    print(f"  {CYAN}--debug-config{RESET}  Print the loaded configuration (redacts keys)")
+    print(f"  {CYAN}--help, -h{RESET}      Show this help message")
+    print(f"  {CYAN}--reinstall{RESET}    Re-run the first-time setup")
+    
+    print(f"\n{YELLOW}Examples:{RESET}")
+    print(f"  ai \"How do I unzip a tar file?\"")
+    print(f"  ai --config")
+    print(f"  cat error.log | ai \"Explain this error briefly\"")
+    return 0 # Return 0 for success

termux_ai-0.2.0/termux_ai.egg-info/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: termux-ai
+Version: 0.2.0
+Summary: A lightweight CLI tool for AI integration in your terminal.
+Author-email: estiaksoyeb <estiakahamed122@gmail.com>, attajak <janrak@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Istiak Ahmmed Soyeb
+        Copyright (c) 2026 attajak (https://github.com/attajak)
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/attajak/termai
+Project-URL: Bug Reports, https://github.com/attajak/termai/issues
+Project-URL: Funding, https://paypal.me/attajak
+Project-URL: Source, https://github.com/attajak/termai
+Keywords: termai,termux-ai,cli,ai,termux
+Requires-Python: >=3.8
+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.
+ * **🧹 Auto-Cleanup:** The installer sets everything up and deletes the repository to save space.
+
+## 📥 Installation
+### Method 1: Global Install (Recommended)
+You can install Termai directly using `pip` or `pipx`:
+```bash
+# Using pip
+pip install .
+
+# Using pipx (cleanest)
+pipx install .
+```
+This will make the `ai` command available globally.
+
+### Method 2: Manual Setup (for Development)
+If you want to contribute or run Termai in a development environment:
+## 🔑 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.
+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 script:
+```bash
+cat install.sh | ai "What does this script do?"
+```
+
+Generate code and save it:
+```bash
+ai "Write a Python hello world script" > hello.py
+```
+
+## ⚙️ 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.
+
+## 🛠 Development
+If you want to contribute or run Termai in a development environment:
+
+1.  **Clone and set up a virtual environment:**
+    ```bash
+    git clone https://github.com/estiaksoyeb/termai
+    cd termai
+    python -m venv .venv
+    source .venv/bin/activate
+    ```
+
+2.  **Install dependencies:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+
+3.  **Run in development mode:**
+    ```bash
+    pip install -e .
+    # Now the 'ai' command will use your local development version.
+    ```
+
+## ❓ 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
+### If installed via pip/pipx:
+```bash
+pip uninstall termai
+# or
+pipx uninstall 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 with ❤️ for CLI enthusiasts
+</p>

termux_ai-0.2.0/termux_ai.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+termai/__init__.py
+termai/__main__.py
+termai/api.py
+termai/cli.py
+termai/config.py
+termai/constants.py
+termai/ui.py
+termai/providers/__init__.py
+termai/providers/base.py
+termai/providers/gemini.py
+termai/providers/openai.py
+termux_ai.egg-info/PKG-INFO
+termux_ai.egg-info/SOURCES.txt
+termux_ai.egg-info/dependency_links.txt
+termux_ai.egg-info/entry_points.txt
+termux_ai.egg-info/requires.txt
+termux_ai.egg-info/top_level.txt

termux_ai-0.2.0/termux_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

termux_ai-0.2.0/termux_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ai = termai.cli:main

termux_ai-0.2.0/termux_ai.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

termux_ai-0.2.0/termux_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+termai