▄█▀▄            ▄▀▄▄
               ▀▄        ▄▀
          ▄▄▄    █▄▄▄▄▄▄█    ▄▄▄
         ▀   ▀█ █▀  ▐▌  ▀█ █▀   ▀
               ██  ▀▐▌▀  ██
          ▄█▀▀▀████████████▀▀▀█
         █      ██████████     ▀▄
         █▄   █▀  ▀▀▀▀▀▀  ▀█   ▄█
          ▀█   █  v.1.0.4 █   █▀

• --help / -h: Get instant help and usage examples without entering the interactive menu
• --version / -v: Quickly check your LucidX version and system information
• Smart Error Handling: Prevents multiple arguments and shows helpful error messages
• Professional CLI: Standard Unix-style command line interface

• New Config Location: ~/.config-vritrasecz/lucidx-config.json
• JSON Format: Clean, structured configuration instead of Python files
• Global Access: Use your API key from any directory on your system
• Auto-Creation: Configuration directory is created automatically
• Enhanced Security: Config stored safely in your home directory

• Argument Validation: Detects and handles invalid arguments gracefully
• Better Error Messages: More informative error handling throughout the tool
• Backward Compatibility: All existing functionality preserved
• Improved Documentation: Updated help system with new features

# Quick help (new!)
python lucidx.py --help

# Check version (new!)
python lucidx.py --version

# Normal interactive mode (unchanged)
python lucidx.py

• Overview
• Features
• Requirements
• Installation
• Configuration
• Usage
• Style Presets
• Screenshots
• File Structure
• Output Management
• Logging System
• Platform Compatibility
• Troubleshooting
• Contributing
• Contact & Support
• License

LucidX is a sophisticated AI-powered image synthesis engine that leverages the Stability AI API to transform text prompts into stunning, high-resolution images. Designed with an intuitive command-line interface, LucidX offers creators, developers, and visionaries a powerful tool to bring their imagination to life through advanced AI image generation.

• 🎨 Multi-Style Generation: Choose from 8 distinctive artistic styles
• 🔧 Interactive CLI: User-friendly command-line interface with visual feedback
• 📱 Cross-Platform: Native support for Linux and Android (Termux)
• 📊 Session Management: Comprehensive logging and progress tracking
• 🛡️ Secure API Handling: Safe storage and management of API credentials
• ⚡ Batch Processing: Generate multiple variations per prompt automatically

• AI Image Generation: Powered by Stability AI's advanced image synthesis models
• Multiple Style Presets: 8 built-in artistic styles including photographic, anime, digital art, and more
• Batch Generation: Automatically creates 4 image variations per prompt
• Smart File Management: Automatic timestamped file naming and organized storage
• Session Logging: Comprehensive activity logs with detailed metadata

• Interactive Menu System: Intuitive navigation through all application features
• Real-time Progress Feedback: Visual indicators during image generation
• Graceful Error Handling: Robust error management with user-friendly messages
• Interrupt Handling: Safe Ctrl+C handling with session cleanup
• Session Summary: Detailed statistics upon completion

• Secure API Key Storage: Encrypted local storage of Stability AI credentials
• API Key Management: Easy configuration and updating of API keys
• Validation: Input validation and API response verification

• Python: Version 3.7 or higher
• Operating System: Linux (any distribution) or Android with Termux
• Internet Connection: Required for Stability AI API access
• Storage: Minimum 100MB free space for generated images

colorama>=0.4.4    # Terminal color formatting
requests>=2.25.1   # HTTP requests for API communication
pathlib            # File path management (built-in)
datetime           # Timestamp generation (built-in)

• Stability AI API Key: Required for image generation
• API Credits: Sufficient credits in your Stability AI account

# Clone the repository
git clone https://github.com/VritraSecz/LucidX.git

# Navigate to project directory
cd LucidX

# Install dependencies
pip3 install -r requirements.txt

# Run the application
python lucidx.py

1. Download the project as ZIP from GitHub
2. Extract to your desired location
3. Install dependencies: pip install colorama requests
4. Run: python lucidx.py

# Update package list
apt update && apt upgrade

# Install Python and Git
apt install python python-pip git

# Clone and setup
git clone https://github.com/VritraSecz/LucidX.git
cd LucidX
pip install -r requirements.txt

# Run
python lucidx.py

1. Obtain Stability AI API Key:

   • Visit Stability AI Platform
   • Create an account and generate an API key
   • Ensure you have sufficient credits

2. Configure in LucidX:

   • Launch LucidX: python lucidx.py
   • Select option [2] Configure API Key
   • Enter your API key when prompted
   • Key is securely stored in core/config.py

3. Update Existing Key:

   • Use the same configuration menu
   • Choose to replace existing key when prompted

The application automatically creates necessary directories:

Linux/PC:

./generated_images/     # Generated images storage
./generation_log.txt    # Session activity log
./last_style.txt        # Temporary style preference

Termux (Android):

/sdcard/LucidX_Images/  # Generated images storage
./generation_log.txt    # Session activity log
./last_style.txt        # Temporary style preference

1. Launch Application

   python lucidx.py

2. Configure API Key (First-time setup)

   • Select option [2] from main menu
   • Enter your Stability AI API key

3. Generate Images

   • Select option [1] Image Generation
   • Choose your preferred style preset (1-8)
   • Enter your text prompt
   • Wait for generation completion

4. View Results

   • Images saved automatically with timestamps
   • Session summary displayed after each batch

• Be Descriptive: Use detailed, specific language
• Add Modifiers: Include quality terms like "high resolution", "cinematic", "detailed"
• Style Keywords: Incorporate style-specific terms that complement your chosen preset
• Composition: Describe the scene composition, lighting, and mood

• Each prompt automatically generates 4 variations
• Seeds are incremented for unique results (1234, 1235, 1236, 1237)
• All images use consistent steps (30) for quality

• View real-time generation progress
• Session statistics available at completion
• Graceful exit with Ctrl+C preserves session data

LucidX offers 8 distinctive artistic styles:

• Styles are remembered during the session
• Stored in temporary last_style.txt file
• Automatically cleaned up on exit

LucidX/
├── lucidx.py                # Application entry point
├── core/                  # Core modules directory
│   ├── genx.py            # Image generation engine
│   ├── banr.py            # ASCII art banners
│   ├── colors.py          # Terminal color definitions
│   └── modulex.py         # Utility functions and menus
├── generated_images/      # Output directory (auto-created)
├── generation_log.txt     # Activity log (auto-created)
├── last_style.txt         # Temporary style storage (auto-created)
├── requirements.txt       # Install required python library
└── README.md              # This documentation

• Application entry point
• Main menu navigation
• Signal handling for graceful interruption

• Image generation engine
• API communication with Stability AI
• File management and batch processing
• Progress tracking and logging

• Menu systems and user interactions
• API key configuration interface
• Help and documentation displays

• ASCII art banners and logos
• Session information display
• Dynamic timestamp generation

• Terminal color scheme definitions
• Consistent visual styling across application

Generated images follow a standardized naming pattern:

YYYYMMDD_HHMMSS.png

Example: 20241220_143052.png (December 20, 2024 at 14:30:52)

• Path: ./generated_images/
• Creation: Automatically created relative to script location
• Permissions: Standard user permissions

• Path: /sdcard/LucidX_Images/
• Creation: Automatically created on SD card storage
• Access: Accessible through file manager apps

• Format: PNG
• Quality: High resolution (API dependent)
• Size: Variable based on Stability AI model output
• Metadata: Generation parameters logged separately

Each generation session creates detailed log entries:

[2024-12-20 14:30:52] Prompt: "sunset over mountain lake" -› 20241220_143052.png
[2024-12-20 14:30:54] Prompt: "sunset over mountain lake" -› 20241220_143054.png
[2024-12-20 14:30:56] Prompt: "sunset over mountain lake" -› 20241220_143056.png
[2024-12-20 14:30:58] Prompt: "sunset over mountain lake" -› 20241220_143058.png

Displayed at the end of each session:

:: LucidX Session Summary ::
 › Prompts entered    : 3
 › Images generated   : 12
 › Output directory   : /home/user/LucidX/generated_images
 › Session completed.

• API errors logged with full response details
• Network issues captured with diagnostic information
• File system errors documented with context

• Ubuntu/Debian: Fully supported
• Fedora/CentOS: Fully supported
• Arch Linux: Fully supported
• Kali Linux: Fully supported (as tested)
• Alpine Linux: Compatible with Python 3.7+

• Installation: Available through Termux package manager
• Storage: Automatic internal storage integration
• Performance: Optimized for mobile hardware
• Permissions: Handles Android storage permissions

sudo apt update
sudo apt install python3 python3-pip
pip3 install colorama requests

pkg update
pkg install python python-pip git
pip install colorama requests

Issue: "API key not configured" or authentication errors Solutions:

• Verify API key is correctly entered (check for extra spaces)
• Ensure API key is active on Stability AI platform
• Check account credit balance
• Reconfigure using menu option [2]

Issue: Connection timeout or network errors Solutions:

• Verify internet connectivity
• Check firewall settings
• Try using VPN if blocked in your region
• Ensure stable internet connection during generation

Issue: Cannot save files or create directories Solutions:

• Check write permissions in current directory
• For Termux: Ensure storage permissions are granted
• Run with appropriate user permissions
• Verify sufficient disk space

Issue: ModuleNotFoundError for colorama or requests Solutions:

pip install --upgrade colorama requests
# or for system-wide installation
pip3 install --upgrade colorama requests

• Close unnecessary applications during generation
• Ensure stable internet connection
• Monitor available RAM and storage

• Use Wi-Fi instead of mobile data for better stability
• Keep device plugged in during long sessions
• Clear app cache if experiencing issues

We welcome contributions from the community! Here's how you can help:

• 🐛 Bug Reports: Submit detailed issue reports
• 💡 Feature Requests: Suggest new functionality
• 🔧 Code Contributions: Submit pull requests
• 📚 Documentation: Improve documentation and examples
• 🎨 Style Presets: Suggest new artistic styles

# Fork the repository on GitHub
# Clone your fork
git clone https://github.com/yourusername/LucidX.git

# Create a feature branch
git checkout -b feature/your-feature-name

# Make changes and test thoroughly
# Commit with descriptive messages
git commit -m "Add: new feature description"

# Push to your fork and create pull request
git push origin feature/your-feature-name

• Follow PEP 8 Python style guidelines
• Include docstrings for new functions
• Test on both Linux and Termux when possible
• Maintain backward compatibility

When reporting issues, please include:

• Python version
• Operating system and version
• Error messages (full traceback)
• Steps to reproduce
• Expected vs actual behavior

1. Check Documentation: Review this README and built-in help
2. Search Issues: Look for existing solutions on GitHub
3. Community Support: Ask questions on Telegram channel
4. Bug Reports: Submit detailed issues on GitHub
5. Direct Contact: Use support bot for urgent issues

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