vexis-cli-1 1.0.0__tar.gz

vexis_cli_1-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT LICENSE
+
+COPYRIGHT (C) 2026 AINOHOgosya-TEAM (VEXIS-CLI)
+
+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.

vexis_cli_1-1.0.0/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: vexis-cli-1
+Version: 1.0.0
+Summary: AI command-line agent for terminal automation and task execution
+Home-page: https://github.com/AInohogosya-team/VEXIS-CLI-1
+Author: AInohogosya-team
+Author-email: AInohogosya@proton.me
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AInohogosya-team/VEXIS-CLI-1
+Project-URL: Repository, https://github.com/AInohogosya-team/VEXIS-CLI-1
+Project-URL: Bug Reports, https://github.com/AInohogosya-team/VEXIS-CLI-1/issues
+Keywords: ai,automation,cli,terminal,command-line
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: structlog>=23.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: PyYAML>=6.0.0
+Requires-Dist: ollama>=0.1.0
+Requires-Dist: pyautogui>=0.9.54; sys_platform == "darwin"
+Requires-Dist: pyobjc-framework-Cocoa>=9.0; sys_platform == "darwin"
+Requires-Dist: pywin32>=306; sys_platform == "win32"
+Requires-Dist: python-xlib>=0.33; sys_platform == "linux"
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+<div align="center">
+
+# VEXIS-CLI-1
+
+</div>
+
+<div align="center">
+
+![VEXIS CLI Logo](https://img.shields.io/badge/VEXIS-CLI%201.0.0-blue?style=for-the-badge)
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue?style=for-the-badge&logo=python)
+![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)
+
+**AI-Powered Command Line Interface for Intelligent Automation**
+
+[VEXIS-CLI-1](https://github.com/AInohogosya-team/VEXIS-CLI-1) is an AI agent derived from VEXIS-1.1 that performs tasks through command execution. It leverages large language models to intelligently interpret natural language commands and execute them through terminal operations, enabling automated workflow management and system administration.
+
+[Quick Start](#quick-start) • [Documentation](#documentation) • [Models](#supported-ai-models) • [Configuration](#configuration) • [Contributing](#contributing)
+
+</div>
+
+## Key Features
+
+### AI-Powered Intelligence
+- **Natural Language Processing**: Execute commands using plain English descriptions
+- **Context-Aware Execution**: Understands your workflow and adapts to your needs
+- **Multi-Model Support**: Compatible with 80+ AI models from 12 major providers
+- **Smart Verification**: Automatic task completion validation with confidence scoring
+
+### Advanced Automation
+- **Two-Phase Engine**: Planning and execution phases for reliable task completion
+- **Cross-Platform Compatibility**: Works seamlessly on macOS, Linux, and Windows
+- **GUI Automation**: Integrate terminal commands with graphical interface interactions
+- **Screenshot Integration**: Visual context capture for enhanced understanding
+
+### Developer Experience
+- **Rich Terminal UI**: Beautiful, informative output with progress indicators
+- **Flexible Configuration**: YAML-based settings with environment variable overrides
+- **Extensible Architecture**: Plugin-ready design for custom integrations
+- **Comprehensive Logging**: Structured logging for debugging and monitoring
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.8 or higher
+- [Ollama](https://ollama.com/) installed and running (for local AI models)
+- Git (for cloning the repository)
+
+### Installation
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/AInohogosya-team/VEXIS-CLI-1.git
+   cd VEXIS-CLI-1
+   ```
+
+2. **Install dependencies**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **Set up Ollama** (optional, for local models)
+   ```bash
+   # Install Ollama
+   curl -fsSL https://ollama.com/install.sh | sh
+   
+   # Pull a recommended model
+   ollama pull llama3.2:latest
+   ```
+
+4. **Run VEXIS-CLI**
+   ```bash
+   python run.py
+   ```
+
+### Your First Command
+
+```bash
+# Start the interactive interface
+python run.py
+
+# Or use direct commands
+vexis-cli "List all Python files in the current directory"
+```
+
+## Supported AI Models
+
+VEXIS-CLI-1 supports **150+ models** from **20 major providers** through Ollama:
+
+### Core Providers
+- **Meta**: Llama 3.1/3.2 series (8B, 70B, 1B, 3B variants)
+- **Google**: Gemma 2/3 series (1B-27B parameters, multimodal capabilities)
+- **DeepSeek**: R1/V3/Coder series (8B-671B, reasoning and coding specialists)
+- **Microsoft**: Phi-3/4 series (3.8B-14B, efficient small models)
+- **Mistral**: Mistral/Large/Ministral series (7B-675B, European open-source leader)
+
+### Advanced Providers
+- **Alibaba (Qwen)**: Qwen 2.5/3 series (0.5B-235B, multilingual with 128K+ context)
+- **IBM**: Granite/Code series (350M-34B, enterprise-grade models)
+- **BigCode**: StarCoder 2 series (3B-15B, specialized for code generation)
+- **Cohere**: Command R series (7B-35B, retrieval-augmented generation)
+- **01.AI**: Yi series (1.5B-34B, bilingual models)
+
+### Specialized Models
+- **Vision-Language**: LLaVA, Moondream, Qwen3-VL (7B-235B)
+- **Coding**: DeepSeek Coder, Qwen Coder, Granite Code, StarCoder 2
+- **Agentic**: Hermes 3, Reflection, Devstral Small 2 (3B-405B)
+- **Cloud-Only**: GPT-OSS, Gemini 3, GLM-5, MiniMax, Kimi (20B-744B)
+
+### Cloud & Local Models
+- **Local Models**: Run entirely on your machine with Ollama
+- **Cloud Models**: Access high-performance models via API
+- **Hybrid Mode**: Seamlessly switch between local and cloud models
+
+<details>
+<summary>Complete Model List</summary>
+
+**Popular Local Models:**
+- `llama3.2:latest` (3B) - Balanced performance with 128K context
+- `qwen2.5:7b` - Multilingual capabilities with 128K context
+- `mistral:7b` - Fast and efficient with 32K context
+- `deepseek-r1:8b` - Advanced reasoning with 128K context
+- `gemma2:9b` - High-performing with 8K context
+- `phi3:mini` - Efficient small model with 4K context
+
+**High-Performance Cloud Models:**
+- `deepseek-v3:671b` - State-of-the-art MoE with 160K context
+- `qwen3:235b` - Advanced MoE with 256K context
+- `mistral-large-3:675b-cloud` - Multimodal enterprise model
+- `gpt-oss:120b-cloud` - Frontier performance
+- `gemini-3-flash-preview:cloud` - Built for speed
+
+</details>
+
+## Usage Examples
+
+### Quick Start
+```bash
+# Start the interactive interface
+python run.py
+
+# Or use direct commands
+vexis-cli "List all Python files in the current directory"
+```
+
+For detailed usage examples, see our [Detailed Guide](DETAILED_GUIDE.md).
+
+## Documentation
+
+- [📖 Detailed Guide](DETAILED_GUIDE.md) - Comprehensive usage examples and advanced features
+- [🔧 Troubleshooting](TROUBLESHOOTING.md) - Common issues and solutions
+- [📚 API Reference](docs/API_REFERENCE.md)
+- [🏗️ Architecture](docs/ARCHITECTURE.md)
+- [⚙️ Configuration](docs/CONFIGURATION.md)
+- [🤝 Contributing](docs/CONTRIBUTING.md)
+
+## Community
+
+- **GitHub Issues**: [Report bugs and request features](https://github.com/AInohogosya-team/VEXIS-CLI-1/issues)
+- **Discussions**: [Join the community discussion](https://github.com/AInohogosya-team/VEXIS-CLI-1/discussions)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📧 Email: AInohogosya@proton.me
+- X: [AInohogosya](https://twitter.com/AInohogosya)
+- Home Page: https://ainohogosya.github.io/home-page/
+
+---
+
+<div align="center">
+
+[Back to top](#vexis-cli-1)
+
+Made with ❤️ by the [AInohogosya-team](https://github.com/AInohogosya-team)
+
+</div>

vexis_cli_1-1.0.0/README.md

@@ -0,0 +1,181 @@
+<div align="center">
+
+# VEXIS-CLI-1
+
+</div>
+
+<div align="center">
+
+![VEXIS CLI Logo](https://img.shields.io/badge/VEXIS-CLI%201.0.0-blue?style=for-the-badge)
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue?style=for-the-badge&logo=python)
+![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)
+
+**AI-Powered Command Line Interface for Intelligent Automation**
+
+[VEXIS-CLI-1](https://github.com/AInohogosya-team/VEXIS-CLI-1) is an AI agent derived from VEXIS-1.1 that performs tasks through command execution. It leverages large language models to intelligently interpret natural language commands and execute them through terminal operations, enabling automated workflow management and system administration.
+
+[Quick Start](#quick-start) • [Documentation](#documentation) • [Models](#supported-ai-models) • [Configuration](#configuration) • [Contributing](#contributing)
+
+</div>
+
+## Key Features
+
+### AI-Powered Intelligence
+- **Natural Language Processing**: Execute commands using plain English descriptions
+- **Context-Aware Execution**: Understands your workflow and adapts to your needs
+- **Multi-Model Support**: Compatible with 80+ AI models from 12 major providers
+- **Smart Verification**: Automatic task completion validation with confidence scoring
+
+### Advanced Automation
+- **Two-Phase Engine**: Planning and execution phases for reliable task completion
+- **Cross-Platform Compatibility**: Works seamlessly on macOS, Linux, and Windows
+- **GUI Automation**: Integrate terminal commands with graphical interface interactions
+- **Screenshot Integration**: Visual context capture for enhanced understanding
+
+### Developer Experience
+- **Rich Terminal UI**: Beautiful, informative output with progress indicators
+- **Flexible Configuration**: YAML-based settings with environment variable overrides
+- **Extensible Architecture**: Plugin-ready design for custom integrations
+- **Comprehensive Logging**: Structured logging for debugging and monitoring
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.8 or higher
+- [Ollama](https://ollama.com/) installed and running (for local AI models)
+- Git (for cloning the repository)
+
+### Installation
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/AInohogosya-team/VEXIS-CLI-1.git
+   cd VEXIS-CLI-1
+   ```
+
+2. **Install dependencies**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **Set up Ollama** (optional, for local models)
+   ```bash
+   # Install Ollama
+   curl -fsSL https://ollama.com/install.sh | sh
+   
+   # Pull a recommended model
+   ollama pull llama3.2:latest
+   ```
+
+4. **Run VEXIS-CLI**
+   ```bash
+   python run.py
+   ```
+
+### Your First Command
+
+```bash
+# Start the interactive interface
+python run.py
+
+# Or use direct commands
+vexis-cli "List all Python files in the current directory"
+```
+
+## Supported AI Models
+
+VEXIS-CLI-1 supports **150+ models** from **20 major providers** through Ollama:
+
+### Core Providers
+- **Meta**: Llama 3.1/3.2 series (8B, 70B, 1B, 3B variants)
+- **Google**: Gemma 2/3 series (1B-27B parameters, multimodal capabilities)
+- **DeepSeek**: R1/V3/Coder series (8B-671B, reasoning and coding specialists)
+- **Microsoft**: Phi-3/4 series (3.8B-14B, efficient small models)
+- **Mistral**: Mistral/Large/Ministral series (7B-675B, European open-source leader)
+
+### Advanced Providers
+- **Alibaba (Qwen)**: Qwen 2.5/3 series (0.5B-235B, multilingual with 128K+ context)
+- **IBM**: Granite/Code series (350M-34B, enterprise-grade models)
+- **BigCode**: StarCoder 2 series (3B-15B, specialized for code generation)
+- **Cohere**: Command R series (7B-35B, retrieval-augmented generation)
+- **01.AI**: Yi series (1.5B-34B, bilingual models)
+
+### Specialized Models
+- **Vision-Language**: LLaVA, Moondream, Qwen3-VL (7B-235B)
+- **Coding**: DeepSeek Coder, Qwen Coder, Granite Code, StarCoder 2
+- **Agentic**: Hermes 3, Reflection, Devstral Small 2 (3B-405B)
+- **Cloud-Only**: GPT-OSS, Gemini 3, GLM-5, MiniMax, Kimi (20B-744B)
+
+### Cloud & Local Models
+- **Local Models**: Run entirely on your machine with Ollama
+- **Cloud Models**: Access high-performance models via API
+- **Hybrid Mode**: Seamlessly switch between local and cloud models
+
+<details>
+<summary>Complete Model List</summary>
+
+**Popular Local Models:**
+- `llama3.2:latest` (3B) - Balanced performance with 128K context
+- `qwen2.5:7b` - Multilingual capabilities with 128K context
+- `mistral:7b` - Fast and efficient with 32K context
+- `deepseek-r1:8b` - Advanced reasoning with 128K context
+- `gemma2:9b` - High-performing with 8K context
+- `phi3:mini` - Efficient small model with 4K context
+
+**High-Performance Cloud Models:**
+- `deepseek-v3:671b` - State-of-the-art MoE with 160K context
+- `qwen3:235b` - Advanced MoE with 256K context
+- `mistral-large-3:675b-cloud` - Multimodal enterprise model
+- `gpt-oss:120b-cloud` - Frontier performance
+- `gemini-3-flash-preview:cloud` - Built for speed
+
+</details>
+
+## Usage Examples
+
+### Quick Start
+```bash
+# Start the interactive interface
+python run.py
+
+# Or use direct commands
+vexis-cli "List all Python files in the current directory"
+```
+
+For detailed usage examples, see our [Detailed Guide](DETAILED_GUIDE.md).
+
+## Documentation
+
+- [📖 Detailed Guide](DETAILED_GUIDE.md) - Comprehensive usage examples and advanced features
+- [🔧 Troubleshooting](TROUBLESHOOTING.md) - Common issues and solutions
+- [📚 API Reference](docs/API_REFERENCE.md)
+- [🏗️ Architecture](docs/ARCHITECTURE.md)
+- [⚙️ Configuration](docs/CONFIGURATION.md)
+- [🤝 Contributing](docs/CONTRIBUTING.md)
+
+## Community
+
+- **GitHub Issues**: [Report bugs and request features](https://github.com/AInohogosya-team/VEXIS-CLI-1/issues)
+- **Discussions**: [Join the community discussion](https://github.com/AInohogosya-team/VEXIS-CLI-1/discussions)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📧 Email: AInohogosya@proton.me
+- X: [AInohogosya](https://twitter.com/AInohogosya)
+- Home Page: https://ainohogosya.github.io/home-page/
+
+---
+
+<div align="center">
+
+[Back to top](#vexis-cli-1)
+
+Made with ❤️ by the [AInohogosya-team](https://github.com/AInohogosya-team)
+
+</div>

vexis_cli_1-1.0.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vexis-cli-1"
+version = "1.0.0"
+description = "AI command-line agent for terminal automation and task execution"
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "AInohogosya-team"}
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "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 :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+keywords = ["ai", "automation", "cli", "terminal", "command-line"]
+requires-python = ">=3.8"
+dependencies = [
+    "Pillow>=10.0.0",
+    "requests>=2.31.0",
+    "numpy>=1.24.0",
+    "structlog>=23.0.0",
+    "rich>=13.0.0",
+    "PyYAML>=6.0.0",
+    "ollama>=0.1.0",
+    "pyautogui>=0.9.54; sys_platform=='darwin'",
+    "pyobjc-framework-Cocoa>=9.0; sys_platform=='darwin'",
+    "pywin32>=306; sys_platform=='win32'",
+    "python-xlib>=0.33; sys_platform=='linux'",
+]
+
+
+[project.scripts]
+"vexis-cli" = "ai_agent.user_interface.main_app:main"
+"vexis-cli-enhanced" = "ai_agent.user_interface.two_phase_app:main"
+
+[project.urls]
+Homepage = "https://github.com/AInohogosya-team/VEXIS-CLI-1"
+Repository = "https://github.com/AInohogosya-team/VEXIS-CLI-1"
+"Bug Reports" = "https://github.com/AInohogosya-team/VEXIS-CLI-1/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+ai_agent = [
+    "config/*.yaml",
+    "config/*.json", 
+    "templates/*.txt",
+    "scripts/*.sh",
+    "scripts/*.ps1",
+]

vexis_cli_1-1.0.0/setup.cfg

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

vexis_cli_1-1.0.0/setup.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""
+Quick Setup Script for VEXIS-CLI
+Automatically checks and fixes common setup issues
+"""
+
+import subprocess
+import sys
+import os
+from pathlib import Path
+
+# PyPI publishing configuration
+from setuptools import setup, find_packages
+
+setup(
+    name="vexis-cli-1",
+    version="1.0.0",
+    description="AI command-line agent for terminal automation and task execution",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="AInohogosya-team",
+    author_email="AInohogosya@proton.me",
+    url="https://github.com/AInohogosya-team/VEXIS-CLI-1",
+    license="MIT",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    include_package_data=True,
+    package_data={
+        "ai_agent": [
+            "config/*.yaml",
+            "config/*.json", 
+            "templates/*.txt",
+            "scripts/*.sh",
+            "scripts/*.ps1",
+        ]
+    },
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "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 :: Software Development :: Automation",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    ],
+    keywords="ai automation cli terminal command-line",
+    python_requires=">=3.8",
+    install_requires=[
+        "Pillow>=10.0.0",
+        "requests>=2.31.0",
+        "numpy>=1.24.0",
+        "structlog>=23.0.0",
+        "rich>=13.0.0",
+        "PyYAML>=6.0.0",
+        "ollama>=0.1.0",
+        "pyautogui>=0.9.54; sys_platform=='darwin'",
+        "pyobjc-framework-Cocoa>=9.0; sys_platform=='darwin'",
+        "pywin32>=306; sys_platform=='win32'",
+        "python-xlib>=0.33; sys_platform=='linux'",
+    ],
+    entry_points={
+        "console_scripts": [
+            "vexis-cli=ai_agent.user_interface.main_app:main",
+            "vexis-cli-enhanced=ai_agent.user_interface.two_phase_app:main",
+        ],
+    },
+)
+
+
+def run_command(cmd, description, check=True):
+    """Run a command and handle errors"""
+    print(f"🔧 {description}...")
+    try:
+        result = subprocess.run(cmd, shell=True, capture_output=True, text=True, check=check)
+        if result.stdout.strip():
+            print(f"✅ {result.stdout.strip()}")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"❌ Failed: {e.stderr.strip()}")
+        return False
+
+
+def check_ollama():
+    """Check and install Ollama if needed"""
+    print("\n=== Checking Ollama ===")
+    
+    try:
+        result = subprocess.run(['ollama', '--version'], capture_output=True, text=True, timeout=5)
+        print(f"✅ Ollama is installed: {result.stdout.strip()}")
+        return True
+    except (subprocess.TimeoutExpired, FileNotFoundError):
+        print("❌ Ollama is not installed")
+        response = input("Would you like to install Ollama? (y/n): ")
+        if response.lower() == 'y':
+            return run_command("curl -fsSL https://ollama.com/install.sh | sh", "Installing Ollama")
+        return False
+
+
+def check_models():
+    """Check and install basic models if needed"""
+    print("\n=== Checking Models ===")
+    
+    try:
+        result = subprocess.run(['ollama', 'list'], capture_output=True, text=True, timeout=10)
+        if result.returncode == 0:
+            lines = result.stdout.strip().split('\n')[1:]  # Skip header
+            models = [line.split()[0] for line in lines if line.strip()]
+            
+            if models:
+                print(f"✅ Found {len(models)} models: {', '.join(models[:3])}")
+                return True
+            else:
+                print("❌ No models found")
+                response = input("Would you like to install a lightweight model? (y/n): ")
+                if response.lower() == 'y':
+                    return run_command("ollama pull llama3.2:1b", "Installing llama3.2:1b model")
+                return False
+    except Exception as e:
+        print(f"❌ Error checking models: {e}")
+        return False
+
+
+def check_python_deps():
+    """Check Python dependencies"""
+    print("\n=== Checking Python Dependencies ===")
+    
+    # Check if we're in a virtual environment
+    if sys.prefix == sys.base_prefix:
+        print("⚠️  Not in a virtual environment")
+        response = input("Would you like to create a virtual environment? (y/n): ")
+        if response.lower() == 'y':
+            if not run_command("python3 -m venv venv", "Creating virtual environment"):
+                return False
+            print("✅ Virtual environment created")
+            print("Please run: source venv/bin/activate && python3 run.py 'your command'")
+            return False
+    else:
+        print("✅ Running in virtual environment")
+    
+    # Check requirements
+    requirements_file = Path("requirements.txt")
+    if requirements_file.exists():
+        # Use --break-system-packages only if in venv or explicitly allowed
+        venv_python = sys.executable
+        pip_cmd = f"{venv_python} -m pip install -r requirements.txt"
+        return run_command(pip_cmd, "Installing Python dependencies")
+    else:
+        print("⚠️  requirements.txt not found")
+        return False
+
+
+def main():
+    """Main setup function"""
+    print("=== VEXIS-CLI Quick Setup ===")
+    print("This script will check and fix common setup issues.\n")
+    
+    # Change to project directory if needed
+    script_dir = Path(__file__).parent
+    os.chdir(script_dir)
+    
+    success_count = 0
+    total_checks = 3
+    
+    # Check each component
+    if check_ollama():
+        success_count += 1
+    
+    if check_models():
+        success_count += 1
+    
+    if check_python_deps():
+        success_count += 1
+    
+    # Summary
+    print(f"\n=== Setup Summary ===")
+    print(f"✅ {success_count}/{total_checks} components ready")
+    
+    if success_count == total_checks:
+        print("🎉 Setup complete! You can now run:")
+        print("python3 run.py \"your instruction here\"")
+    else:
+        print("⚠️  Some issues remain. Please fix them manually.")
+        print("You can also run: python3 check_models.py for detailed model status.")
+
+
+if __name__ == "__main__":
+    main()