Metadata-Version: 2.4
Name: vexis-cli
Version: 1.2.1
Summary: AI command-line agent for terminal automation and task execution
Author: VEXIS Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/vexis-project/VEXIS-CLI-1.2
Project-URL: Repository, https://github.com/vexis-project/VEXIS-CLI-1.2
Project-URL: Bug Reports, https://github.com/vexis-project/VEXIS-CLI-1.2/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 :: System :: Systems Administration
Classifier: Topic :: Utilities
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: license-file


<div align="center">

# 🤖 VEXIS-CLI-1.2

![VEXIS CLI Banner](image-1.png)

[![Python](https://img.shields.io/badge/Python-3.9%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge&logo=opensource)](LICENSE)
[![Status](https://img.shields.io/badge/Status-Active-orange?style=for-the-badge&logo=rocket)]()
[![Providers](https://img.shields.io/badge/AI_Providers-13+-purple?style=for-the-badge&logo=artstation)](#ai-providers)

**🧠 Transform natural language into powerful terminal automation**

*Your intelligent CLI companion that understands what you want to do and gets it done*

---

[🚀 Quick Start](#installation) • [📖 Documentation](#documentation) • [🎯 Features](#features) • [⚙️ Configuration](#configuration) • [🤝 Contributing](#contributing)

</div>

---

## ✨ Why VEXIS-CLI?

Tired of memorizing complex command-line syntax? **VEXIS-CLI** bridges the gap between human language and terminal commands. Just tell it what you want to accomplish in plain English, and watch as it intelligently executes your requests.

🎯 **"Create a backup of my documents folder"** → Automated backup script  
🎯 **"Find all Python files with syntax errors"** → Code analysis and reporting  
🎯 **"Set up a development environment for React"** → Complete project setup  

---

## 🌟 Key Features

### 🧠 **Intelligent Command Understanding**
- Natural language processing that understands context and intent
- Smart error recovery and self-correction
- Learning from your usage patterns

### ⚡ **Lightning-Fast Execution**
- One-liner command execution
- Parallel processing for complex tasks
- Real-time progress feedback

### 🔗 **Universal AI Provider Support**
- **13+ AI providers** including local and cloud options
- Seamless switching between providers
- Optimized for each provider's strengths

### 🛡️ **Enterprise-Grade Reliability**
- Comprehensive error handling
- Rollback capabilities for failed operations
- Detailed logging and debugging

### 🎨 **Beautiful User Experience**
- Intuitive provider selection interface
- Rich terminal output with syntax highlighting
- Progress indicators and status updates

---

## 🤖 AI Providers

### 🏠 **Local & Hybrid**
<div align="center">

**🦙 Ollama** - Privacy-first local AI with cloud backup  
*Recommended models: `gemma3:4b`, `qwen2.5:3b`, `deepseek-r1:7b`*

</div>

### ☁️ **Cloud Powerhouses**
<div align="center">

| Provider | Specialty | Speed | Best For |
|----------|-----------|-------|----------|
| 🚀 **Groq** | Ultra-fast inference | ⚡⚡⚡⚡⚡ | Real-time tasks |
| 🔮 **Google Gemini** | Enterprise-grade | ⚡⚡⚡⚡ | Business applications |
| 🧠 **OpenAI** | Advanced reasoning | ⚡⚡⚡⚡ | Complex problem-solving |
| 🎭 **Anthropic** | Strong logic | ⚡⚡⚡⚡ | Analytical tasks |
| ⚡ **xAI** | Real-time knowledge | ⚡⚡⚡⚡ | Current events |
| 🦊 **Meta** | Open models | ⚡⚡⚡ | Research |
| 🌊 **Mistral** | Multilingual | ⚡⚡⚡ | Global applications |
| 🔷 **Azure** | Enterprise integration | ⚡⚡⚡ | Corporate environments |
| 🏔️ **AWS Bedrock** | Scalable infrastructure | ⚡⚡⚡ | Large deployments |
| 🎯 **Cohere** | Business workflows | ⚡⚡⚡ | Enterprise automation |
| 🔍 **DeepSeek** | Advanced reasoning | ⚡⚡⚡ | Technical tasks |
| 🤝 **Together AI** | Open-source hosting | ⚡⚡⚡ | Custom models |

</div>

> 💡 **Our Top Picks**: For the best experience, we recommend **Groq** (speed), **Google Gemini** (reliability), **OpenAI** (capability), and **Ollama** (privacy).

---

## 🚀 Installation

### 🎯 **Quick Start (3 commands)**
```bash
git clone https://github.com/vexis-project/VEXIS-CLI-1.2.git
cd VEXIS-CLI-1.2
python3 run.py "list files"  # Auto-installs dependencies!
```

### ✅ **System Requirements**
- **Python 3.9+** 
- **4GB+ RAM** for local models
- **API keys** for cloud providers (get them in minutes)
- **Optional**: Ollama for local AI (`curl -fsSL https://ollama.ai/install.sh | sh`)

### 🎨 **First Run Experience**
When you first run VEXIS-CLI, you'll see our beautiful provider selection interface:

![Provider Selection Interface](Choose_model.png)

---

## 💻 Usage Examples

### 🏁 **Getting Started**
```bash
# Simple file operations
python3 run.py "create a README for my project"
python3 run.py "find all files larger than 10MB"
python3 run.py "organize my downloads folder by date"

# Development tasks
python3 run.py "set up a Python virtual environment and install requirements"
python3 run.py "run tests and generate coverage report"
python3 run.py "deploy this project to GitHub Pages"

# System administration
python3 run.py "check disk space and clean up temporary files"
python3 run.py "monitor system resources for 5 minutes"
python3 run.py "backup important configuration files"
```

### 🎛️ **Advanced Options**
```bash
# Debug mode for developers
python3 run.py "complex task" --debug

# Skip provider selection (uses your preferred choice)
python3 run.py "quick task" --no-prompt

# Batch processing
python3 run.py "process all images in ./photos --resize 800x600 --quality 85"
```

---

## ⚙️ Configuration

### 📝 **Simple Setup**
Edit `config.yaml` to personalize your experience:

```yaml
api:
  preferred_provider: "groq"  # Your go-to AI provider
  local_endpoint: "http://localhost:11434"
  local_model: "gemma3:4b"     # Stable and fast
  timeout: 120                 # Seconds to wait
  max_retries: 3              # Auto-retry on failures

# Personalization
user:
  name: "Your Name"
  preferred_style: "concise"   # "concise", "detailed", "friendly"
  auto_confirm: false         # Auto-confirm safe operations
```

### 🎯 **Model Recommendations**
- **🏠 Local**: `gemma3:4b` (balanced), `qwen2.5:3b` (fast), `deepseek-r1:7b` (smart)
- **☁️ Cloud**: `gemini-3.1-pro` (reliable), `gpt-5.4` (capable), `claude-opus-4.6` (analytical)

---

## 🏗️ Architecture

### 🧠 **Two-Phase Intelligence Engine**

```mermaid
graph LR
    A[Natural Language Input] --> B[Phase 1: Command Planning]
    B --> C[Intent Analysis]
    B --> D[Strategy Generation]
    B --> E[Risk Assessment]
    C --> F[Phase 2: Terminal Execution]
    D --> F
    E --> F
    F --> G[Smart Execution]
    F --> H[Error Recovery]
    F --> I[Result Validation]
    G --> J[Success!]
    H --> J
    I --> J
```

### � **Core Components**
- **🎯 TwoPhaseEngine** - Orchestrates intelligent command execution
- **🤖 ModelRunner** - Unified interface for all AI providers
- **📝 CommandParser** - Advanced natural language understanding
- **✅ TaskVerifier** - Safety checks and validation systems

---

## 🛠️ Development & Contributing

### 🤝 **How to Contribute**
We love community contributions! Here's how you can help:

1. **🐛 Report Issues**: Found a bug? [Open an issue](https://github.com/vexis-project/VEXIS-CLI-1.2/issues)
2. **💡 Feature Requests**: Have an idea? [Start a discussion](https://github.com/vexis-project/VEXIS-CLI-1.2/discussions)
3. **🔧 Pull Requests**: Ready to code? Check our [contributing guidelines](CONTRIBUTING.md)
4. **📖 Documentation**: Help improve docs - even small fixes help!

### 🧪 **Testing**
```bash
# Run the test suite
python3 -m pytest tests/

# Test specific providers
python3 test_cloud_models.py
python3 check_environment.py
```

---

## 📚 Documentation

| Document | Description | Link |
|----------|-------------|------|
| 📖 **Detailed User Guide** | Comprehensive setup and usage | [DETAILED_GUIDE.md](./DETAILED_GUIDE.md) |
| ⚙️ **Configuration** | Configuration options | [docs/CONFIGURATION.md](./docs/CONFIGURATION.md) |
| 🔧 **Troubleshooting** | Common issues and solutions | [docs/TROUBLESHOOTING.md](./docs/TROUBLESHOOTING.md) |

---

## 🏆 Community & Support

### 💬 **Get Help**
- 📖 [Documentation](./docs/)
- 🐛 [Issue Tracker](https://github.com/vexis-project/VEXIS-CLI-1.2/issues)
- 💬 [Discussions](https://github.com/vexis-project/VEXIS-CLI-1.2/discussions)

### ⭐ **Show Your Love**
- **Star the repo** - It helps others discover VEXIS-CLI
- **Share your use cases** - We love to see what you build!

---

<div align="center">

## 🎉 Transform Your Terminal Experience

**VEXIS-CLI makes command-line automation intuitive and accessible**

[🚀 Get Started Now](#installation) • [⭐ Star on GitHub](https://github.com/vexis-project/VEXIS-CLI-1.2) • [📖 Read the Docs](./docs/)

---

### Made with ❤️ by the VEXIS Project

*Empowering developers with intelligent automation*

---

![VEXIS Logo](https://img.shields.io/badge/VEXIS-Project-blue?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMTMuMDkgOC4yNkwyMCA5TDEzLjA5IDE1Ljc0TDEyIDIyTDEwLjkxIDE1Ljc0TDQgOUwxMC45MSA4LjI2TDEyIDJaIiBmaWxsPSJ3aGl0ZSIvPgo8L3N2Zz4K)

</div>
