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
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.
๐ธ Screenshots
๐ฌ Chat Mode Interface
Beautiful chat interface with AI-powered text generation and rich formatting
๐ค Agent Mode Interface
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+Nfor 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
- Package: xibe-chat-cli
- Version: 0.9.0 (Latest Release!)
- PyPI: https://pypi.org/project/xibe-chat-cli/
- License: CC BY-NC-SA 4.0
- 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 generationagent_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:
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
- ๐ PyPI Package: 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!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
48dd458c45018975bedf425ae7892767ff2844e8065f3816eb85ea406a168386
|
|
| MD5 |
c32a2a24a7352e55a6d48afce9340f18
|
|
| BLAKE2b-256 |
7db802804202f7b08247d42bcfaf46d6d1f43de301d74f522558008faea19c59
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e21cc394be68647953108d615f49864094c9c0de7a9c91aafb245acd25dae388
|
|
| MD5 |
ae6ae28533894ad4ad6b2e127d834f28
|
|
| BLAKE2b-256 |
60b3387d1bc9d4d1cb3b170b3eb45e2fb38dd655783cfa5d3178edb81e55fa57
|