Metadata-Version: 2.4
Name: xibe-chat-cli
Version: 0.8.2
Summary: XIBE-CHAT CLI - AI-powered terminal assistant for text and image generation
Home-page: https://github.com/iotserver24/xibe-chat-cli
Author: iotserver24
Author-email: iotserver24 <iotserver24@gmail.com>
License: Proprietary
Project-URL: Homepage, https://github.com/iotserver24/xibe-chat-cli
Project-URL: Repository, https://github.com/iotserver24/xibe-chat-cli
Project-URL: Documentation, https://github.com/iotserver24/xibe-chat-cli#readme
Project-URL: Bug Tracker, https://github.com/iotserver24/xibe-chat-cli/issues
Keywords: ai,chat,cli,image-generation,text-generation,terminal,assistant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: Other/Proprietary License
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 :: Communications :: Chat
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: System :: Shells
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyfiglet>=0.8
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: rich>=13.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: packaging>=21.0
Provides-Extra: dev
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# XIBE-CHAT CLI 🚀

> AI-powered terminal assistant for text, image generation, and CLI automation

[![PyPI version](https://badge.fury.io/py/xibe-chat-cli.svg)](https://badge.fury.io/py/xibe-chat-cli)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://pypi.org/project/xibe-chat-cli/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/xibe-chat-cli.svg)](https://pypistats.org/packages/xibe-chat-cli)
[![Downloads](https://pepy.tech/badge/xibe-chat-cli/month)](https://pepy.tech/project/xibe-chat-cli)

A beautiful, feature-rich CLI application that brings AI text generation, image generation, and intelligent CLI automation directly to your terminal. Built with Python and featuring a rich interface powered by Rich library.

[![Donate](https://img.shields.io/badge/Donate-Razorpay-blue?style=for-the-badge&logo=razorpay)](https://razorpay.me/@megavault)

## 📸 Screenshots

### 💬 Chat Mode Interface
![XIBE-CHAT Interface](https://raw.githubusercontent.com/iotserver24/codex/refs/heads/master/chat.png)

*Beautiful chat interface with AI-powered text generation and rich formatting*

### 🤖 Agent Mode Interface  
![XIBE Agent Mode](https://raw.githubusercontent.com/iotserver24/codex/refs/heads/master/agent.png)

*Intelligent CLI automation with smart decision making and task execution*

## 🆕 What's New in v0.8.1

### 🤖 **AI-Powered Conversational Intelligence**
- **Smart Query Analysis**: AI automatically understands your intent and decides between text responses or image generation
- **Conversational Image Generation**: AI responds naturally before creating images (no more "img:" prefixes needed!)
- **Enhanced Image Prompts**: AI creates detailed, vivid prompts for stunning results
- **Natural Language Processing**: Just chat naturally - the AI figures out what you want

### 💬 **Conversational AI Responses**
- **Human-like Interactions**: AI responds conversationally before generating images
- **Contextual Acknowledgments**: "Sure! I'd be happy to generate an image of..." + beautiful image
- **Intelligent Decision Making**: AI understands visual requests in natural language
- **Seamless Experience**: Feels like chatting with a helpful human assistant who can create images

### 🚀 **Enhanced User Experience**
- **No Prefixes Required**: Say "show me Paris" instead of "img: show me Paris"
- **Faster Interactions**: Direct image generation while maintaining conversational flow
- **Improved Model Selection**: Better AI model integration and performance
- **Enhanced Stability**: More reliable operation with improved error handling

## ✨ Features

### 🤖 AI Text Generation
- **Multiple AI Models**: Choose from various text generation models
- **Conversation Memory**: Maintains context across multiple exchanges
- **Rich Formatting**: Beautiful markdown rendering with syntax highlighting
- **Model Switching**: Change models on the fly without losing chat history

### 🎯 **Conversational AI (NEW!)**
- **Natural Language Understanding**: AI automatically understands your intent
- **Smart Decision Making**: Automatically chooses between text responses and image generation
- **Conversational Responses**: AI responds like a human assistant before creating images
- **No Special Commands**: Just chat naturally - AI handles the rest!

### 🖼️ AI Image Generation
- **Enhanced Prompts**: AI automatically improves your prompts for better results
- **Multiple Models**: Support for flux, kontext, turbo, nanobanana, and more
- **High Quality**: 1024x1024 resolution with safety filtering
- **Private Generation**: Images not shared in public feeds
- **Premium Features**: No watermarks, NO rate limits!

### 💾 Smart Memory System
- **Model Preferences**: Remembers your preferred AI models
- **Auto-Load**: Uses saved preferences on startup
- **Easy Reset**: Reset preferences anytime with `/reset`

### 🤖 AI Agent Mode
- **Intelligent CLI Automation**: AI can execute commands and perform tasks automatically
- **Smart Decision Making**: AI automatically decides whether to chat or execute tasks
- **Visible PowerShell Integration**: Watch the AI work in real-time with visible CLI windows
- **Natural Language Tasks**: Just tell the AI what you want - it figures out how to do it
- **Seamless Integration**: Switch between chat and agent modes with `/agent`
- **Enhanced Performance**: Faster task execution and improved reliability

### 🎨 Beautiful Interface
- **Rich Terminal UI**: Beautiful ASCII art logo and colorful interface
- **Multi-line Input**: Support for multi-line messages with `Ctrl+N`
- **Command System**: Intuitive slash commands for all features
- **Cross-Platform**: Works on Windows, macOS, and Linux
- **Improved Responsiveness**: Faster rendering and smoother interactions

## 🚀 Quick Start

### Installation

**Via pip (recommended):**
```bash
pip install xibe-chat-cli
```

**Run the CLI:**
```bash
xibe-chat
# or use the short alias
xibe
```



## 📖 Usage

### Basic Commands

```bash
# Start the CLI
xibe-chat

# Chat with AI (NEW: Conversational!)
You: Hello! How are you?

# Generate images naturally (NEW!)
You: show me a beautiful sunset over mountains
🤖 AI: Sure! I'd be happy to generate a stunning sunset scene...
🎨 [Image generates automatically]

# Traditional image generation (still works)
You: img: a beautiful sunset over mountains

# Get help
You: /help
```

### Available Commands

| Command | Description |
|---------|-------------|
| `/help` | Show all commands and usage |
| `/clear` | Clear terminal and show logo |
| `/new` | Start a new chat session |
| `/reset` | Reset saved model preferences |
| `/image-settings` | View image generation settings |
| `/agent` | Switch to Agent Mode |
| `models` | Show available AI models |
| `switch` | Change AI models |
| `exit/quit` | End the session |

### Input Methods

#### 🎯 **Natural Language (NEW!)**
- **Conversational AI**: Just chat naturally - AI understands and responds appropriately
- **Smart Image Generation**: Say "show me a sunset" or "draw a dragon" - AI handles it automatically
- **Intelligent Responses**: AI responds conversationally before generating images

#### 📝 **Traditional Methods (Still Supported)**
- **Normal Text**: Just type and press Enter for regular chat
- **Multi-line**: Press `Ctrl+N` for new lines, Enter to send
- **Direct Image Generation**: Use `img:` prefix for instant generation (e.g., `img: cute cat`)

#### 💬 **Examples of Natural Language:**
```bash
# Image Generation (Automatic)
You: show me a beautiful sunset over Paris
🤖 AI: Sure! I'd be happy to show you a stunning sunset over Paris...
🎨 [Generates beautiful sunset image]

You: draw a futuristic city
🤖 AI: Great idea! I'll create a futuristic cityscape for you...
🎨 [Generates futuristic city image]

# Text Responses (Automatic)
You: what does quantum physics mean?
🤖 AI: Quantum physics is the study of matter and energy at...
💬 [Provides text explanation]
```

## 🤖 Agent Mode

XIBE-CHAT features an intelligent **Agent Mode** that can execute CLI commands and perform tasks automatically!

### Getting Started with Agent Mode

```bash
# Start the CLI
xibe-chat

# Switch to Agent Mode
/agent

# Now you can:
# 1. Chat normally
You: Hello, how are you?

# 2. Give tasks in natural language
You: Create a folder called "my_project"
You: List all files in this directory
You: Make a Python file with hello world

# 3. Watch the AI work in real-time!
```

### 🤖 How Agent Mode Works

#### **Smart Decision Making**
The AI automatically decides whether your input should be:
- **Chat Response**: Normal conversation
- **Task Execution**: CLI automation

#### **Natural Language Tasks**
Just tell the AI what you want - it figures out how to do it:

```bash
# Examples of tasks the AI can handle:
"Create a new folder called test"
"List all files in the current directory"  
"Make a Python script that prints hello world"
"Copy all .txt files to a backup folder"
"Show me the current working directory"
"Install a Python package called requests"
```

#### **Visible PowerShell Integration**
- **Auto-starts PowerShell** when tasks are detected
- **Visible windows** so you can see what the AI is doing
- **Real-time feedback** with command execution progress

### 🎯 Agent Mode Commands

| Command | Description |
|---------|-------------|
| `/agent` | Switch to Agent Mode |
| `/sessions` | Show active CLI sessions |
| `/close-agent` | Close all agent sessions |
| `/help` | Show agent mode help |
| `/clear` | Clear screen and show agent logo |
| `/new` | Start fresh agent session |
| `/exit-agent` | Return to chat mode |
| `agent: open powershell visible` | Start visible PowerShell session |
| `agent: <command>` | Execute direct command |

### ✨ Agent Mode Features

#### **Automatic Session Management**
- **Smart Detection**: AI decides when to start CLI sessions
- **Auto-Recovery**: Gracefully handles session failures
- **Session Persistence**: Sessions survive mode switches

#### **Error Handling**
- **Graceful Recovery**: Continues working even when commands fail
- **User-Friendly Messages**: Clear feedback about what's happening
- **Fallback Options**: Falls back to chat if automation fails

#### **Visual Feedback**
- **Decision Indicators**: Shows whether AI will chat or execute tasks
- **Progress Tracking**: Real-time updates on task execution
- **Command History**: See what commands were executed

### 🎨 Agent Mode Interface

When you switch to Agent Mode, you'll see:
- **Orange gradient "XIBE AGENT" logo**
- **Comprehensive welcome screen** with examples
- **Smart decision indicators** for each input
- **Real-time task execution** with visible PowerShell windows

## ⚙️ Configuration

### 🎯 No Setup Required!

XIBE-CHAT CLI comes pre-configured with premium API access:

- ✅ **No Watermarks**: Clean images without logos
- ✅ **Enhanced Rate Limits**: Higher usage limits for better performance
- ✅ **Private Generation**: Your images stay private
- ✅ **Optimized Performance**: Faster response times and improved reliability

### Model Preferences

Your preferred models are automatically saved in `xibe_chat_config.json`:

```json
{
  "text_model": "mistral",
  "image_model": "flux",
  "last_updated": "2024-01-15T10:30:45.123456"
}
```

## 🖼️ Image Generation Features

### Enhanced API Parameters
- **Enhance**: AI improves your prompts automatically
- **Safe Mode**: Strict NSFW filtering enabled
- **Private**: Images not shared publicly
- **High Quality**: 1024x1024 resolution
- **No Watermarks**: Clean images included

### Available Models
- **flux**: High-quality general purpose
- **kontext**: Image-to-image editing
- **turbo**: Fast generation
- **nanobanana**: Advanced image editing
- **gptimage**: GPT-powered generation

## 🔧 Technical Details

### Package Information
- **Package**: xibe-chat-cli
- **Version**: 0.8.1 (Latest Release!)
- **PyPI**: [https://pypi.org/project/xibe-chat-cli/](https://pypi.org/project/xibe-chat-cli/)
- **License**: Proprietary
- **Author**: iotserver24

### System Requirements
- Python 3.8+
- Windows, macOS, or Linux
- Internet connection for AI services
- PowerShell (Windows) / Terminal (macOS/Linux) for Agent Mode

## 📦 Requirements

- Python 3.8+
- pyfiglet
- python-dotenv
- requests
- rich
- prompt-toolkit
- packaging (for version management)

## 🏗️ Architecture

### Modular Design
XIBE-CHAT CLI features a clean, modular architecture:

- **`ai_cli.py`**: Main chat interface, AI-powered conversational intelligence, and smart image/text generation
- **`agent_mode.py`**: Intelligent CLI automation and task execution
- **Conversational AI Engine**: Natural language understanding and intent recognition
- **Smart Decision System**: Automatically routes queries to appropriate AI services
- **Separate branding**: Different logos and interfaces for each mode
- **Seamless switching**: Switch between modes without losing state

### Agent Mode Components
- **Smart Decision Engine**: AI-powered classification of user intent
- **CLI Session Management**: Automatic PowerShell/terminal session handling
- **Task Execution Engine**: Step-by-step command execution with feedback
- **Error Recovery System**: Graceful handling of failures and edge cases

## 🚀 AI-Powered Features in v0.8.1

### 🤖 Conversational AI Intelligence
- **Natural Language Processing**: AI understands and responds to natural human language
- **Smart Intent Recognition**: Automatically detects when users want images vs. text responses
- **Conversational Responses**: AI responds like a human assistant before generating content
- **Enhanced Image Prompts**: AI creates detailed, vivid prompts for stunning visual results

### Enhanced User Experience
- **No Prefixes Required**: Say "show me Paris" instead of "img: show me Paris"
- **Faster Interactions**: Direct routing to appropriate AI services
- **Conversational Flow**: Natural back-and-forth like chatting with a human
- **Improved Responsiveness**: Smoother interactions with intelligent routing

### Technical Optimizations
- **AI-Powered Decision Making**: Eliminates manual command prefixes and routing
- **Optimized API Calls**: Smart routing reduces unnecessary requests
- **Enhanced Error Handling**: Better recovery from AI service issues
- **Streamlined Architecture**: Clean separation of conversational AI and direct commands

## 💖 Support the Project

If you find XIBE-CHAT useful, consider supporting its development:

[![Donate](https://img.shields.io/badge/Donate-Razorpay-blue?style=for-the-badge&logo=razorpay)](https://razorpay.me/@megavault)

**Every contribution helps improve XIBE-CHAT for everyone! 🙏**

## 📞 Support & Contact

For support, feature requests, or questions:
- 📧 Email: iotserver24@gmail.com
- 🐛 Issues: Contact via email
- 💬 Feedback: We welcome your suggestions

## 📄 License

This is proprietary software. All rights reserved.

## 🙏 Acknowledgments

- [Pollinations AI](https://pollinations.ai) for the amazing AI API
- [Rich](https://github.com/Textualize/rich) for the beautiful terminal interface
- [Prompt Toolkit](https://github.com/prompt-toolkit/python-prompt-toolkit) for advanced input handling
- **OpenAI** for the powerful language models that power Agent Mode's intelligent task execution

## 📞 Additional Support

- 📖 PyPI Package: [https://pypi.org/project/xibe-chat-cli/](https://pypi.org/project/xibe-chat-cli/)
- 🔄 Updates: `pip install --upgrade xibe-chat-cli`

---

**Made with ❤️ by iotserver24**

*Star this repository if you find it helpful!*

[![Donate](https://img.shields.io/badge/Support%20Development-Donate-green?style=for-the-badge)](https://razorpay.me/@megavault)
