Skip to main content

XIBE-CHAT CLI - AI-powered terminal assistant for text and image generation

Project description

XIBE-CHAT CLI ๐Ÿš€

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

PyPI version Python 3.8+ License: CC BY-NC-SA 4.0 PyPI - Downloads Downloads

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

๐Ÿ“ธ Screenshots

๐Ÿ’ฌ Chat Mode Interface

XIBE-CHAT Interface

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

๐Ÿค– Agent Mode Interface

XIBE Agent Mode

Intelligent CLI automation with smart decision making and task execution

๐Ÿ†• What's New in v0.9.0

๐Ÿš€ Powered by Pollinations AI

  • Free & Unlimited: Still runs completely free thanks to Pollinations AI
  • New Models: Access to Gemini 2.5 Flash Lite, OpenAI GPT-5 Mini, and more
  • API Key Required: Get your free API key from https://enter.pollinations.ai
  • Enhanced Reliability: Improved connection stability and error handling

๐Ÿค– 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):

pip install xibe-chat-cli

Run the CLI:

xibe-chat
# or use the short alias
xibe

๐Ÿ“– Usage

Basic Commands

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

# 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

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

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

{
  "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

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

๐Ÿค– 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

Every contribution helps improve XIBE-CHAT for everyone! ๐Ÿ™

[!NOTE] Donations are highly appreciated to keep this project alive and free!

๐Ÿ“ž Support & Contact

For support, feature requests, or questions:

  • ๐Ÿ“ง Email: iotserver24@gmail.com
  • ๐Ÿ› Issues: Contact via email
  • ๐Ÿ’ฌ Feedback: We welcome your suggestions

๐Ÿ“„ License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

You are free to:

  • Share โ€” copy and redistribute the material in any medium or format
  • Adapt โ€” remix, transform, and build upon the material

Under the following terms:

  • Attribution โ€” You must give appropriate credit, provide a link to the license, and indicate if changes were made
  • NonCommercial โ€” You may not use the material for commercial purposes
  • ShareAlike โ€” If you remix, transform, or build upon the material, you must distribute your contributions under the same license

For more details, see the LICENSE file or visit https://creativecommons.org/licenses/by-nc-sa/4.0/

๐Ÿ™ Acknowledgments

  • Pollinations AI for the amazing AI API
  • Rich for the beautiful terminal interface
  • Prompt Toolkit for advanced input handling
  • OpenAI for the powerful language models that power Agent Mode's intelligent task execution

๐Ÿ“ž Additional Support


Made with โค๏ธ by iotserver24

Star this repository if you find it helpful!

Donate

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xibe_chat_cli-0.9.0.tar.gz (48.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xibe_chat_cli-0.9.0-py3-none-any.whl (41.3 kB view details)

Uploaded Python 3

File details

Details for the file xibe_chat_cli-0.9.0.tar.gz.

File metadata

  • Download URL: xibe_chat_cli-0.9.0.tar.gz
  • Upload date:
  • Size: 48.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for xibe_chat_cli-0.9.0.tar.gz
Algorithm Hash digest
SHA256 48dd458c45018975bedf425ae7892767ff2844e8065f3816eb85ea406a168386
MD5 c32a2a24a7352e55a6d48afce9340f18
BLAKE2b-256 7db802804202f7b08247d42bcfaf46d6d1f43de301d74f522558008faea19c59

See more details on using hashes here.

File details

Details for the file xibe_chat_cli-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: xibe_chat_cli-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 41.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for xibe_chat_cli-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e21cc394be68647953108d615f49864094c9c0de7a9c91aafb245acd25dae388
MD5 ae6ae28533894ad4ad6b2e127d834f28
BLAKE2b-256 60b3387d1bc9d4d1cb3b170b3eb45e2fb38dd655783cfa5d3178edb81e55fa57

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page