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 and image generation

PyPI version Python 3.8+ License: MIT

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+N for 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.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📞 Support


Made with ❤️ by iotserver24

Star this repository if you find it helpful!

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.5.0.tar.gz (19.5 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.5.0-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: xibe_chat_cli-0.5.0.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.8

File hashes

Hashes for xibe_chat_cli-0.5.0.tar.gz
Algorithm Hash digest
SHA256 4498ecdb244158dff80539c8121d5863864f458446b4952765c8c8002028f283
MD5 7ed0af388923d234dffdae0ca8c5f2b4
BLAKE2b-256 dc7782ba7de405ad5ed638a3147a90e3ed31ce8d7ea1337e32ebb723f2e9b74e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: xibe_chat_cli-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.8

File hashes

Hashes for xibe_chat_cli-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c5fd307fa90399aa0772fdd07c69e026a381f8db1030d1cbaf7aeef9380b265e
MD5 efe8b7de8f6dc54179643fbd2d766992
BLAKE2b-256 b5503ab5ab40031916887eb5c5287185fe716f11afc5edd7703c11cb9039a3fa

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