aether-ai-agent-cli 1.1.4__py3-none-any.whl

aether_ai_agent_cli-1.1.4.dist-info/METADATA

@@ -0,0 +1,309 @@
+Metadata-Version: 2.4
+Name: aether-ai-agent-cli
+Version: 1.1.4
+Summary: Aether Core AI v110 — Universal AI Gateway CLI (Python Wrapper)
+Home-page: https://github.com/Krylo-60/aether-ai-cli
+Author: Krishiv PB
+Author-email: krylobloxyt@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# Aether AI CLI
+
+> ⚡ **Universal AI Gateway** — 13+ providers, free & paid models, cyberpunk terminal
+
+[![npm version](https://img.shields.io/npm/v/@krishivpb60/aether-ai-cli.svg)](https://www.npmjs.com/package/@krishivpb60/aether-ai-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-cyan.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-≥18.0.0-green.svg)](https://nodejs.org)
+
+```
+  ╔═══════════════════════════════════════════════════════════╗
+  ║     █████╗ ███████╗████████╗██╗  ██╗███████╗██████╗    ║
+  ║    ██╔══██╗██╔════╝╚══██╔══╝██║  ██║██╔════╝██╔══██╗   ║
+  ║    ███████║█████╗     ██║   ████████║█████╗  ██████╔╝   ║
+  ║    ██╔══██║██╔══╝     ██║   ██╔══██║██╔══╝  ██╔══██╗   ║
+  ║    ██║  ██║███████╗   ██║   ██║  ██║███████╗██║  ██║   ║
+  ║    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝   ║
+  ╚═══════════════════════════════════════════════════════════╝
+```
+
+**Aether Core AI v110** is a production-ready, globally installable command-line AI assistant that connects to **any AI provider in the world** — both free and paid. Chat with GPT-4o, Claude, Gemini, Llama, Mixtral, DeepSeek, and 50+ more models, all from one terminal.
+
+---
+
+## ✨ Features
+
+- 🌐 **13+ AI Providers** — OpenAI, Anthropic, Google, Groq, Together, Mistral, OpenRouter, DeepSeek, Cerebras, Cohere, Perplexity, Fireworks, xAI
+- 🆓 **Free Models Included** — Groq, Together AI, Cerebras, OpenRouter, and Cohere all offer generous free tiers
+- 💬 **Interactive Chat** — Full terminal chat with slash commands, mode switching, and file attachments
+- ⚡ **Single-Shot Queries** — Quick one-off questions directly from the CLI
+- 🧠 **4 Reasoning Modes** — Synthesis, Research, Architect, Titan Fusion — each with unique system prompts
+- 📎 **File Context Injection** — Attach code files, logs, or documents for context-aware AI responses
+- 🔄 **Failover Mesh** — Automatic failback across all configured providers
+- 🔢 **Local Math Solver** — Evaluates mathematical expressions without an API call
+- 🤖 **Krylo Companion** — Offline cyberpunk companion bot when no API keys are configured
+- 🔐 **Your Keys, Your Control** — API keys stored locally on YOUR machine, never transmitted anywhere
+- 📤 **Export Conversations** — Save full chat history as Markdown files
+- 🎨 **Cyberpunk UI** — Neon colors, ASCII art, signal bars, and mode badges
+- 🎭 **4 Color Themes** — Cyberpunk, Matrix, Synthwave, Crimson — switch with `/theme`
+- ⌨️ **Custom Commands** — Create reusable prompt shortcuts with `/cmd add`
+- 📝 **File Creation** — AI can create files on your system with path override prompts
+- 📊 **Live Telemetry** — Real-time response latency & tokens/sec in the status bar
+- 🎮 **Mini-Game** — Built-in mainframe hacking game (`/game`)
+- 📋 **Clipboard Copy** — Copy last response to clipboard with `/copy`
+
+---
+
+## 🚀 Quick Start
+
+### Install globally
+
+```bash
+npm install -g @krishivpb60/aether-ai-cli
+```
+
+### Or run directly with npx
+
+```bash
+npx @krishivpb60/aether-ai-cli chat
+```
+
+### Setup (Interactive Wizard)
+
+```bash
+aether setup
+```
+
+The wizard walks you through configuring providers — **start with free ones!**
+
+### Or set keys manually
+
+```bash
+# Free providers (recommended to start)
+aether config set GROQ_API_KEY gsk_your_key_here
+aether config set GOOGLE_API_KEY AIza_your_key_here
+aether config set OPENROUTER_API_KEY sk-or-your_key_here
+
+# Paid providers
+aether config set OPENAI_API_KEY sk-your_key_here
+aether config set ANTHROPIC_API_KEY sk-ant-your_key_here
+```
+
+### Start chatting
+
+```bash
+aether chat
+```
+
+### Quick one-shot query
+
+```bash
+aether ask "Explain quantum computing in simple terms"
+```
+
+---
+
+## 📦 Supported Providers
+
+| Provider | Key | Free Tier | Default Model |
+|----------|-----|-----------|---------------|
+| **Groq** | `GROQ_API_KEY` | ✅ Generous | `llama-3.3-70b-versatile` |
+| **Together AI** | `TOGETHER_API_KEY` | ✅ Free credits | `Meta-Llama-3.1-70B-Instruct-Turbo` |
+| **Cerebras** | `CEREBRAS_API_KEY` | ✅ Free tier | `llama-3.3-70b` |
+| **OpenRouter** | `OPENROUTER_API_KEY` | ✅ Free models | `llama-3.1-70b-instruct:free` |
+| **Google Gemini** | `GOOGLE_API_KEY` | ✅ Free tier | `gemini-2.5-flash` |
+| **Cohere** | `COHERE_API_KEY` | ✅ Dev free | `command-r-plus` |
+| **Fireworks AI** | `FIREWORKS_API_KEY` | ✅ Free tier | `llama-v3p1-70b-instruct` |
+| **OpenAI** | `OPENAI_API_KEY` | 💳 Paid | `gpt-4o` |
+| **Anthropic** | `ANTHROPIC_API_KEY` | 💳 Paid | `claude-sonnet-4` |
+| **xAI** | `XAI_API_KEY` | 💳 Paid | `grok-2` |
+| **Mistral** | `MISTRAL_API_KEY` | 💳 Paid | `mistral-large-latest` |
+| **DeepSeek** | `DEEPSEEK_API_KEY` | 💳 Paid | `deepseek-chat` |
+| **Perplexity** | `PERPLEXITY_API_KEY` | 💳 Paid | `sonar` |
+
+> 💡 **Tip:** Start with **Groq** (fastest, free) or **Google Gemini** (most capable free tier). You can configure multiple providers and Aether will automatically failover between them!
+
+---
+
+## 🎮 Commands
+
+### Core Commands
+
+```bash
+aether chat                    # Interactive chat session
+aether ask "your question"     # Single-shot query
+aether setup                   # Guided provider setup wizard
+```
+
+### Configuration
+
+```bash
+aether config set <KEY> <value>   # Set a config value
+aether config get <KEY>           # Get a config value
+aether config list                # List all config (keys masked)
+aether config delete <KEY>        # Delete a config key
+aether config reset               # Delete all config
+aether config path                # Show config file location
+```
+
+### Discovery
+
+```bash
+aether providers               # List all 13+ supported providers
+aether providers --free        # Show only free-tier providers
+aether models                  # List all available models
+aether models groq             # Models for a specific provider
+aether modes                   # List reasoning modes
+aether status                  # System status & active providers
+```
+
+### Flags
+
+```bash
+aether ask "prompt" --mode research     # Use specific reasoning mode
+aether ask "prompt" --file error.log    # Attach file context
+aether ask "prompt" --model gpt-4o      # Override model
+aether ask "prompt" --raw               # Raw text output (for piping)
+aether chat --mode architect            # Start chat in specific mode
+```
+
+---
+
+## 💬 Chat Commands
+
+Inside interactive chat mode, use these slash commands:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show all commands |
+| `/mode <name>` | Switch reasoning mode (synthesis, research, architect, titan) |
+| `/modes` | List all modes with signal bars |
+| `/theme <name>` | Switch visual theme (cyberpunk, matrix, synthwave, crimson) |
+| `/themes` | List available color themes |
+| `/attach <file>` | Attach a file for context (supports Tab autocomplete!) |
+| `/files` | List attached files |
+| `/clear` | Clear terminal screen |
+| `/providers` | Show active providers |
+| `/export` | Export chat to Markdown |
+| `/copy` | Copy last response to clipboard |
+| `/write <file>` | Extract last code block and save to file |
+| `/cmd list` | List custom command shortcuts |
+| `/cmd add <name> <template>` | Create a custom command shortcut |
+| `/cmd remove <name>` | Delete a custom command |
+| `/game` | Start the mainframe hacking mini-game |
+| `/status` | Session status & telemetry |
+| `/history-clear` | Clear saved chat history |
+| `/exit` | End session |
+
+---
+
+## 🧠 Reasoning Modes
+
+| Mode | Layer | Style | Signal |
+|------|-------|-------|--------|
+| **Synthesis** | v2.5 | Balanced, clean, direct | ████████░░ 80% |
+| **Research** | v104 | Deep analysis, evidence-based | █████████░ 85% |
+| **Architect** | v55 | Systems thinking, debugging | █████████░ 90% |
+| **Titan Fusion** | v110 | Premium, maximum signal density | █████████░ 95% |
+
+---
+
+## 🔐 Security
+
+- **Your keys stay on YOUR machine** — stored at `~/.aether/config.json`
+- **No keys are bundled** in the package
+- **No telemetry** — zero data collection
+- **Keys are masked** when displayed (`aether config list`)
+- **Environment variables** also supported as fallback
+
+---
+
+## 🔄 Failover Mesh
+
+Aether routes your prompt through all configured providers automatically:
+
+```
+Your Prompt
+    ↓
+[Provider 1] → Success? → Response ✓
+    ↓ (fail)
+[Provider 2] → Success? → Response ✓
+    ↓ (fail)
+[Provider N] → Success? → Response ✓
+    ↓ (all fail)
+[Krylo Companion] → Local Response ✓
+```
+
+If a provider returns an error (rate limit, quota, etc.), Aether automatically tries the next one. Configure multiple free providers for maximum resilience!
+
+---
+
+## 📁 File Attachment
+
+Attach code files, logs, configs, or documents for context-aware responses:
+
+```bash
+# From CLI
+aether ask "What's wrong with this code?" --file buggy.js
+
+# In chat mode
+/attach error.log
+What errors are in this file?
+```
+
+**Supported file types:** `.js`, `.ts`, `.py`, `.html`, `.css`, `.json`, `.md`, `.txt`, `.log`, `.yaml`, `.xml`, `.toml`, `.sql`, `.go`, `.rs`, `.java`, `.c`, `.cpp`, `.rb`, `.php`, `.swift`, `.kt`, `.dart`, `.vue`, `.svelte`, `.sh`, `.bat`, `.ps1`, `.env`, `.csv`
+
+---
+
+## 🏗️ Development
+
+```bash
+# Clone the repo
+git clone https://github.com/Krylo-60/aether-ai-cli.git
+cd aether-ai-cli
+
+# Install dependencies
+npm install
+
+# Link for local development
+npm link
+
+# Test
+aether --help
+aether status
+aether ask "hello"
+```
+
+---
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+## 👨‍💻 Author
+
+**Krishiv PB** ([@Krylo-60](https://github.com/Krylo-60))
+
+> *"Stay cyberpunk. ⚡"*
+
+---
+
+<p align="center">
+  <b>⚡ Aether Core AI v110 — Fusion Command Station ⚡</b><br>
+  <i>Universal AI Gateway for the Terminal</i>
+</p>

aether_ai_agent_cli-1.1.4.dist-info/RECORD

@@ -0,0 +1,25 @@
+aether_ai_agent_cli-1.1.4.dist-info/licenses/LICENSE,sha256=9kKNPpKXSdgtv9HXqHorQiVH6NQKwF34mvXadmIGHYI,1079
+aether_pip/__init__.py,sha256=ZBxjigfvm7oT267tIUeTBR2cZ1e9U4oX6fB_HyGUy04,36
+aether_pip/cli.py,sha256=GIoPS33uzVWEFQII-IVzTLCmAZYs0HTIzKXysI-OeN0,2044
+aether_pip/node_project/package-lock.json,sha256=-F9OM9j_VKaPJ2sttMzfRzt7LSAbm4-rU_8cHwXejbk,28433
+aether_pip/node_project/package.json,sha256=0xxBwmEAFCkIgbXdO_iFw5tF6EwqMz7MHfqc-g4zxqk,1084
+aether_pip/node_project/bin/aether.js,sha256=Amzo0lT1WRl3ylYkc6IV87C6Zdbk-YZClqf8U9c3v8Y,541
+aether_pip/node_project/src/chat.js,sha256=5kccC7tCJbgcETFncnJmIg0bJ96OhNzEdVNb2zu7EO0,34894
+aether_pip/node_project/src/cli.js,sha256=pMN6DfLw1HtkBBXZYlE5Wr_jjvOXa5P1-0oAMCHWOy4,24823
+aether_pip/node_project/src/config.js,sha256=6GPf8aiMY8uH6Omgkm3U2G0n-lJ-ldFk3ik1RtnnFLs,5592
+aether_pip/node_project/src/file-parser.js,sha256=LZfxQKv01J6YkdrvvesUx86qTGF_2Dk2q7yw4WTXsBE,2955
+aether_pip/node_project/src/modes.js,sha256=0NTZGqLeyZ-PErfOJePvC5igBmP2CicYGGdEIAivpls,7292
+aether_pip/node_project/src/ai/fallback.js,sha256=A7ZJEj9QbiJMc8qKKlEQqYg5Mevs7NNlZgsnDSfEoNw,6935
+aether_pip/node_project/src/ai/google.js,sha256=b-nbXalbGV9lCVpxWXnXrlQ3GG_0i55nitJk9q7FPR8,2791
+aether_pip/node_project/src/ai/providers.js,sha256=XBnqn3-d0IdOEAc61gLBM48Ugt7w6stmbQxWO4h6gKQ,7500
+aether_pip/node_project/src/ai/router.js,sha256=sVmdmvTDU3_CBaktGMaeBJ3ONmeckkiYNnQH8Fs9hek,4271
+aether_pip/node_project/src/ai/universal.js,sha256=mbPDhv8lx1sqUwcqptNtBucNYnqiglucsLvl5Nzs47Q,17176
+aether_pip/node_project/src/ai/xai.js,sha256=pGzfmao82HGF0OXBIGLSaFlQr94Nhws9A7vfYlyADNs,1661
+aether_pip/node_project/src/ui/banner.js,sha256=ZnURFLicjZ7IfqVRBxo0uveg5XZM8GFxfZgbeMMBDfY,3431
+aether_pip/node_project/src/ui/spinner.js,sha256=5XOVr3fNODswUmSyST_aaKxQoXa-Zgvt7mVxDwPZyPE,1361
+aether_pip/node_project/src/ui/theme.js,sha256=JO2CSLDzcvQAw-mS5-WfhkZBD4PPZfPfxEdVeB6cg8g,7434
+aether_ai_agent_cli-1.1.4.dist-info/METADATA,sha256=GqxSWBZWrye6LB85P-ymnnE3Q62w9toCNNahq7Zqe4U,11604
+aether_ai_agent_cli-1.1.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+aether_ai_agent_cli-1.1.4.dist-info/entry_points.txt,sha256=fq7dU4sEmrsiKzKCnkap7LxjZRKlg8qm_RO2fgTBBHk,51
+aether_ai_agent_cli-1.1.4.dist-info/top_level.txt,sha256=M2mo27cNqNARNn0DgMIfxsyeniBhsID-UeSBeHMOzZU,11
+aether_ai_agent_cli-1.1.4.dist-info/RECORD,,

aether_ai_agent_cli-1.1.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aether_ai_agent_cli-1.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aether-pip = aether_pip.cli:main

aether_ai_agent_cli-1.1.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Krishiv PB (@Krylo-60)
+
+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.

aether_ai_agent_cli-1.1.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+aether_pip

aether_pip/__init__.py

@@ -0,0 +1 @@
+# Aether AI CLI Pip Package Wrapper

aether_pip/cli.py

@@ -0,0 +1,49 @@
+import sys
+import os
+import subprocess
+import shutil
+
+def main():
+    # Find the Node.js entry point absolute path inside aether_pip/node_project
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    node_project_dir = os.path.join(script_dir, "node_project")
+    aether_js = os.path.join(node_project_dir, "bin", "aether.js")
+    
+    # If not found globally, check dev layout relative to current working directory
+    if not os.path.exists(aether_js):
+        aether_js = os.path.join(os.getcwd(), "bin", "aether.js")
+        node_project_dir = os.getcwd()
+
+    if not shutil.which("node"):
+        print("Error: Node.js is required to run Aether AI CLI.", file=sys.stderr)
+        print("Please install Node.js (https://nodejs.org) and try again.", file=sys.stderr)
+        sys.exit(1)
+
+    # Check if node_modules exists in the node_project directory.
+    # If not, automatically run npm install inside that directory!
+    node_modules_dir = os.path.join(node_project_dir, "node_modules")
+    if not os.path.exists(node_modules_dir):
+        print("First-time launch check: Installing node dependencies via npm...")
+        npm_cmd = shutil.which("npm")
+        if not npm_cmd:
+            print("Error: npm is required to install Node dependencies.", file=sys.stderr)
+            print("Please install Node.js/npm and try again.", file=sys.stderr)
+            sys.exit(1)
+        
+        # On Windows, run npm using shell=True to handle cmd/bat resolution
+        subprocess.run([npm_cmd, "install", "--no-audit", "--no-fund"], cwd=node_project_dir, shell=(os.name == "nt"))
+
+    try:
+        # Run node aether.js passing all command line arguments
+        cmd = ["node", aether_js] + sys.argv[1:]
+        result = subprocess.run(cmd, check=False)
+        sys.exit(result.returncode)
+    except KeyboardInterrupt:
+        print("\nSession terminated by user.")
+        sys.exit(0)
+    except Exception as e:
+        print(f"Error running Aether: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

aether_pip/node_project/bin/aether.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// ═══════════════════════════════════════════════════════════
+// AETHER AI CLI — Entry Point
+// Universal AI Gateway — 13+ Providers, Free & Paid
+// ═══════════════════════════════════════════════════════════
+
+import { createCLI } from "../src/cli.js";
+
+createCLI(process.argv);