CLI: Initial.

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,10 @@
+---
+title: UltimaX Intelligence CLI
+short_description: Run GPT-4.1 (Nano) on your local terminal for free.
+license: apache-2.0
+emoji: ⚡
+colorFrom: yellow
+colorTo: purple
+sdk: static
+pinned: false
+---

assets/bin/ai

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+#
+# SPDX-FileCopyrightText: Hadad <hadad@linuxmail.org>
+# SPDX-License-Identifier: Apache-2.0
+#
+# UltimaX Intelligence CLI
+# 0.0.1 version
+#
+
+import sys
+import argparse
+
+try:
+    import pollinations  # Provider.
+except ImportError:
+    print("Module 'pollinations' not found. Install it with: pip install pollinations pollinations.ai", file=sys.stderr)
+    sys.exit(2)  # Exit to signal missing dependency.
+
+def response(output):  # Print non-stream responses.
+    try:
+        if hasattr(output, "text"):  # Handle objects with .text.
+            print(output.text)  # Print text and return.
+            return
+        if isinstance(output, dict) and "text" in output:  # Handle dicts with 'text'.
+            print(output["text"])  # Print dict value and return.
+            return
+        if isinstance(output, (list, tuple)):  # Handle sequences of parts.
+            try:
+                print("".join(map(str, output)))  # Join parts and return.
+                return
+            except Exception:
+                pass  # Fall through to fallback.
+    except Exception:
+        pass  # Fall through on any inspection error.
+    print(str(output))  # Fallback printing.
+
+def main():  # Script entry point.
+    parser = argparse.ArgumentParser(description="UltimaX Intelligence")
+    parser.add_argument("text", nargs="*", help="Helper for the user input.")  # Positional text.
+    parser.add_argument("--no-stream", dest="stream", action="store_false", help="Use non-streaming mode.")
+    args = parser.parse_args()  # Parse flags and positionals.
+
+    if not args.text:  # No positional text given.
+        if sys.stdin.isatty():  # Nothing piped in.
+            print("Empty input. Request cancelled.", file=sys.stderr)  # Immediate cancel on empty invocation.
+            sys.exit(1)  # Exit to indicate no work done.
+        input = sys.stdin.read()  # Read piped stdin.
+    elif len(args.text) == 1 and args.text[0] == "-":  # Explicit stdin sentinel.
+        if sys.stdin.isatty():  # No data to read.
+            print("Empty input. Request cancelled.", file=sys.stderr)  # Cancel when '-' without pipe.
+            sys.exit(1)  # Exit to indicate no work done.
+        input = sys.stdin.read()  # Read piped stdin.
+    else:
+        input = " ".join(args.text)  # Join positional pieces.
+
+    # Reject empty or whitespace-only input.
+    if not input or input.strip() == "":  # Guard against blanks.
+        print("Empty input. Request cancelled.", file=sys.stderr)  # Consistent message.
+        sys.exit(1)  # Exit to indicate no work done.
+
+    # Build model instance.
+    try:
+        model = pollinations.Text()  # OpenAI: GPT-4.1 (Nano).
+    except Exception:
+        print("Failed to construct default model.", file=sys.stderr)  # High level failure.
+        import traceback  # Lazy import for error details.
+        traceback.print_exc()  # Show stack trace for debugging.
+        sys.exit(1)  # Exit due to setup failure.
+
+    try:
+        if args.stream:  # Streaming path.
+            for token in model(input, stream=True):  # Iterate tokens.
+                try:
+                    if isinstance(token, (str, bytes)):  # Strings or bytes.
+                        print(token.decode() if isinstance(token, bytes) else token, end="", flush=True)  # Emit token.
+                    elif isinstance(token, dict) and "text" in token:  # Dict tokens.
+                        print(token["text"], end="", flush=True)  # Emit dict text.
+                    elif hasattr(token, "text"):  # Object tokens with .text.
+                        print(token.text, end="", flush=True)  # Emit attribute.
+                    else:
+                        print(str(token), end="", flush=True)  # Emit generic.
+                except Exception:
+                    print(str(token), end="", flush=True)  # Fallback on token error.
+            print()  # Newline after stream completes.
+        else:  # Non-streaming path.
+            output = model(input, stream=False)  # Get full response.
+            response(output)  # Print.
+    except KeyboardInterrupt:
+        print("\nInterrupted by user.", file=sys.stderr)  # User aborted.
+        sys.exit(130)  # Conventional Ctrl+C code.
+    except Exception:
+        print("Error while calling the model:", file=sys.stderr)  # Runtime failure.
+        import traceback  # Lazy import for details.
+        traceback.print_exc()  # Show stack trace.
+        sys.exit(1)  # Exit on runtime error.
+
+main()  # Run immediately for terminal use.

assets/bin/installer.sh

@@ -0,0 +1,33 @@
+#!/bin/sh
+#
+# SPDX-FileCopyrightText: Hadad <hadad@linuxmail.org>
+# SPDX-License-Identifier: Apache-2.0
+#
+
+echo "Welcome to UltimaX Intelligence CLI"
+echo ""
+echo ""
+echo "Installing required Python packages..."
+pip install pollinations pollinations.ai --upgrade
+echo "Installation complete."
+echo ""
+echo ""
+echo "Downloading the main script..."
+wget https://huggingface.co/spaces/umint/cli/raw/main/assets/bin/ai
+echo "Download complete."
+echo ""
+echo ""
+echo "Setting executable permission..."
+chmod a+x ai
+echo "Permission set."
+echo ""
+echo ""
+echo "Removing installer script..."
+rm installer.sh
+echo "Done."
+echo ""
+echo ""
+echo "Example usage:"
+echo "./ai Your message here"
+echo ""
+echo ""

assets/css/style.css

@@ -0,0 +1,29 @@
+/*
+ * SPDX-FileCopyrightText: Hadad <hadad@linuxmail.org>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+body {
+    font-family: Arial, sans-serif;
+    line-height: 1.6;
+    margin: 20px;
+    background-color: #f9f9f9;
+}
+
+h1, h2, h3 {
+    color: #333;
+}
+
+code, pre {
+    background-color: #eee;
+    padding: 6px 10px;
+    border-radius: 4px;
+}
+
+pre {
+    overflow-x: auto;
+}
+
+.section {
+    margin-bottom: 30px;
+}

index.html

@@ -0,0 +1,49 @@
+<!-- 
+  SPDX-FileCopyrightText: Hadad <hadad@linuxmail.org>
+  SPDX-License-Identifier: Apache-2.0
+-->
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <link rel="stylesheet" href="assets/css/style.css" />
+</head>
+<body>
+    <div class="section">
+        <p>
+            This script provides a simple command-line interface
+            for the UltimaX Intelligence CLI.
+            It supports streaming and non-streaming modes.
+            Compatible for Linux/MacOS/Windows (WSL)/Termux.
+        </p>
+    </div>
+
+    <div class="section">
+        <h2>Installation</h2>
+        <p>Make sure Python 3 is installed and then install the required dependency:</p>
+        <pre><code>
+# Download the installer script
+wget https://huggingface.co/spaces/umint/cli/raw/main/assets/bin/installer.sh
+
+# Set proper permission
+chmod a+x installer.sh
+
+# Run the installer script
+./installer.sh
+        </code></pre>
+    </div>
+
+    <div class="section">
+        <h2>Usage</h2>
+        <pre><code>
+# Streaming (default)
+./ai Tell me about yourself.
+
+# Non-streaming mode
+./ai Tell me about yourself. --no-stream
+        </code></pre>
+    </div>
+</body>
+</html>