XIBE-CHAT CLI - AI-powered terminal assistant for text and image generation
Project description
XIBE-CHAT CLI 🚀
AI-powered terminal assistant for text and image generation
A beautiful, feature-rich CLI application that brings AI text and image generation directly to your terminal. Built with Python and featuring a rich interface powered by Rich library.
✨ 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
💾 Smart Memory System
- Model Preferences: Remembers your preferred AI models
- Auto-Load: Uses saved preferences on startup
- Easy Reset: Reset preferences anytime with
/reset
🎨 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
🚀 Quick Start
Installation
Via pip (recommended):
pip install xibe-chat-cli
Run the CLI:
xibe-chat
# or use the short alias
xibe
One-line Install Script
# Download and run installer
python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/iotserver24/xibe-chat-cli/main/install.py').read())"
📖 Usage
Basic Commands
# 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 |
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+Nfor new lines, Enter to send - Image Generation: Prefix with
img:(e.g.,img: cute cat)
⚙️ Configuration
API Token (Optional but Recommended)
Set your API token for better rate limits and premium features:
# Windows
set API_TOKEN=your_token_here
# macOS/Linux
export API_TOKEN=your_token_here
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 (with API token)
Available Models
- flux: High-quality general purpose
- kontext: Image-to-image editing
- turbo: Fast generation
- nanobanana: Advanced image editing
- gptimage: GPT-powered generation
🔧 Development
Setup Development Environment
# Clone the repository
git clone https://github.com/iotserver24/xibe-chat-cli.git
cd xibe-chat-cli
# Install in development mode
pip install -e .
# Install development dependencies
pip install -e ".[dev]"
Building from Source
# Build package
python -m build
# Install locally
pip install dist/xibe_chat_cli-1.0.0-py3-none-any.whl
Creating Executables
# Install PyInstaller
pip install pyinstaller
# Create executable
pyinstaller --onefile --name xibe-chat xibe_chat.py
📦 Requirements
- Python 3.8+
- pyfiglet
- python-dotenv
- requests
- rich
- prompt-toolkit
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Pollinations AI for the amazing AI API
- Rich for the beautiful terminal interface
- Prompt Toolkit for advanced input handling
📞 Support
- 📧 Email: your-email@example.com
- 🐛 Issues: GitHub Issues
- 📖 Documentation: GitHub Repository
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.5.1.tar.gz.
File metadata
- Download URL: xibe_chat_cli-0.5.1.tar.gz
- Upload date:
- Size: 20.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83bc28aa0f741a31656f1a230cb4821ea01ab5762a4db7f3efaba497a109badf
|
|
| MD5 |
62ad6eb4964d271513614c039b4ff18b
|
|
| BLAKE2b-256 |
dfb885a7d94a0977524413f7a3126c1130136dce2a04989a4524723726e802b9
|
File details
Details for the file xibe_chat_cli-0.5.1-py3-none-any.whl.
File metadata
- Download URL: xibe_chat_cli-0.5.1-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
39b5a6ecd06861fa3fd659845966a11bf15e5dbd08a88c336f12befc815a75f2
|
|
| MD5 |
5498f343db9a9a51ee4f04ec2bdc8b93
|
|
| BLAKE2b-256 |
55b3e68eb5b6c7d6793dd2ef9f4cd2c66696f10425d3aee4ebf6677f9a329e27
|