Metadata-Version: 2.4
Name: xibe-chat-cli
Version: 0.7.1
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/)

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.7.0

- **Enhanced Performance** - Faster startup and improved responsiveness
- **Better Error Handling** - More robust error recovery and user feedback
- **Improved User Experience** - Cleaner interface and smoother interactions
- **Optimized Resource Usage** - Better memory management and efficiency
- **Enhanced Stability** - More reliable operation across different systems

## ✨ 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

### 🖼️ 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
You: Hello! How are you?

# Generate images
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

- **Normal Text**: Just type and press Enter
- **Multi-line**: Press `Ctrl+N` for new lines, Enter to send
- **Image Generation**: Prefix with `img:` (e.g., `img: cute cat`)

## 🤖 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.7.0 (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 and text/image generation
- **`agent_mode.py`**: Intelligent CLI automation and task execution
- **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

## 🚀 Performance Improvements in v0.7.0

### Enhanced User Experience
- **Faster Startup**: Reduced initialization time for quicker access
- **Improved Responsiveness**: Smoother interactions and faster command processing
- **Better Memory Management**: Optimized resource usage for longer sessions
- **Enhanced Error Handling**: More robust error recovery and user feedback

### Technical Optimizations
- **Optimized API Calls**: Reduced latency and improved reliability
- **Better Resource Management**: More efficient memory and CPU usage
- **Enhanced Cross-Platform Support**: Improved compatibility across Windows, macOS, and Linux
- **Streamlined Code Architecture**: Cleaner, more maintainable codebase

## 💖 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)
