🚀 Installation Guide - Bravura

Get your professional GUI framework up and running in minutes

---

📋 System Requirements

Required

✅ Python 3.7 or higher (Download Python)
✅ tkinter (included with Python)
✅ Windows 10+, macOS 10.14+, or Linux (Ubuntu 18.04+)

Optional

🎵 pygame (for loading screen background music)
🎨 Pillow (for advanced image handling)

---

⚡ Quick Installation

Step 1: Install Bravura Package

Download your purchased Bravura package
Install using pip:

```bash

# Install from .whl file

pip install bravura-1.0.0-py3-none-any.whl

# Or install from extracted folder

pip install .

```

Verify installation:

```python

python -c "from bravura import get_audio_analyzer_framework; print('✅ Bravura installed successfully!')"

```

Step 2: Install Optional Dependencies (Recommended)


# For loading screen music support
pip install pygame

# For advanced image handling (optional)
pip install Pillow

Step 3: Test Installation


# test_bravura.py
from bravura import get_audio_analyzer_framework

# Get the framework class and create instance
AppClass = get_audio_analyzer_framework()
app = AppClass()

# Run your application
app.run()

🎉 Success! You should see a professional GUI framework window open.

---

🏗️ Project Setup Options

Option 1: pip Install (Recommended)

Install Bravura as a Python package:


# Install from wheel file
pip install bravura-1.0.0-py3-none-any.whl

# Or install with optional dependencies
pip install bravura-1.0.0-py3-none-any.whl pygame Pillow

Project structure:


YourProject/
├── main.py                   # Your main application
├── config.py                 # Optional configuration
└── your_modules/             # Your application code

Option 2: Virtual Environment (Best Practice)


# Create virtual environment
python -m venv myproject_env
cd myproject_env

# Activate environment
# Windows:
Scripts\activate
# macOS/Linux:
source bin/activate

# Install Bravura
pip install path/to/bravura-1.0.0-py3-none-any.whl

# Install optional dependencies
pip install pygame Pillow

# Test installation
python -c "from bravura import get_audio_analyzer_framework; print('✅ Ready!')"

Option 3: Development Install

For development or customization:


# Extract package and install in editable mode
cd path/to/extracted/bravura
pip install -e .

# This allows you to modify the source code
# and changes will be reflected immediately

---

🛠️ Configuration

Basic Configuration

Create a config.py file:


# config.py
GUI_CONFIG = {
    'window_title': 'My Professional Application',
    'window_size': '1000x630',
    'theme': 'professional',
    'enable_music': True,
    'log_level': 'INFO'
}

Import in Your Application


# main.py
from bravura import get_audio_analyzer_framework
from config import GUI_CONFIG

AppClass = get_audio_analyzer_framework()
app = AppClass()
app.root.title(GUI_CONFIG['window_title'])
app.run()

---

🧪 Verify Installation

Quick Test


# test_bravura.py
from bravura import get_audio_analyzer_framework

print("Testing Bravura installation...")

# Get the framework class
AppClass = get_audio_analyzer_framework()
print("✅ Framework imported successfully")

# Create instance
app = AppClass()
print("✅ App instance created successfully")

# Optionally run the GUI (will open a window)
# app.run()

print("🎉 Bravura is installed and working!")

Check Dependencies


# test_dependencies.py
import sys

def check_dependencies():
    print("🔍 Checking Bravura dependencies...")

    # Check Python version
    print(f"Python version: {sys.version}")
    if sys.version_info < (3, 7):
        print("❌ Python 3.7+ required")
        return False
    print("✅ Python version OK")

    # Check tkinter
    try:
        import tkinter as tk
        print("✅ tkinter available")
    except ImportError:
        print("❌ tkinter not available")
        return False

    # Check optional dependencies
    try:
        import pygame
        print("✅ pygame available (music support enabled)")
    except ImportError:
        print("⚠️  pygame not installed (music support disabled)")

    try:
        from PIL import Image
        print("✅ Pillow available (advanced image support)")
    except ImportError:
        print("⚠️  Pillow not installed (basic image support only)")

    print("🎉 Installation verification complete!")
    return True

if __name__ == "__main__":
    check_dependencies()

---

🐛 Troubleshooting

Common Issues

Issue: `ModuleNotFoundError: No module named 'bravura'`

Solution:


# Ensure Bravura is properly installed
pip install path/to/bravura-1.0.0-py3-none-any.whl

# Verify installation
python -c "import bravura; print('✅ Bravura found')"

# If in virtual environment, ensure it's activated
# Windows: Scripts\activate
# macOS/Linux: source bin/activate

Issue: `tkinter.TclError: couldn't connect to display`

Solution (Linux):


# Install tkinter development package
sudo apt-get install python3-tk

# Or for older systems
sudo apt-get install python-tk

Issue: Loading screen music doesn't work

Solution:


# Install pygame
pip install pygame

# If still not working, check audio system
python -c "import pygame; pygame.mixer.init(); print('Audio system OK')"

Issue: Application starts slowly

Cause: Initial framework initialization

Solution: This is normal for first-time initialization. Subsequent startups will be faster.


# Minimal startup (no demo features)
from bravura import get_audio_analyzer_framework

AppClass = get_audio_analyzer_framework()
app = AppClass()
app.run()

Issue: High DPI display makes text blurry (Windows)

Solution:


# Add to your main.py before creating GUI
import ctypes
try:
    ctypes.windll.shcore.SetProcessDpiAwareness(1)
except:
    pass  # Ignore if not on Windows

Issue: Permission denied errors

Solution:

Ensure you have write permissions to the project directory
Run as administrator if necessary (Windows)
Check file permissions (macOS/Linux): chmod +x *.py

---

📦 Packaging Your Application

Using PyInstaller


# Install PyInstaller
pip install pyinstaller

# Create executable
pyinstaller --onefile --windowed main.py

# Include additional files if needed
pyinstaller --onefile --windowed --add-data "components;components" main.py

Using cx_Freeze


# setup.py for cx_Freeze
from cx_Freeze import setup, Executable

setup(
    name="My Professional App",
    version="1.0",
    description="Built with Bravura",
    executables=[Executable("main.py", base="Win32GUI")]
)

Distribution Checklist

✅ Test on target platforms
✅ Include all required files
✅ Test with fresh Python installation
✅ Include license file (your application license)
✅ Create installer if needed

---

🔄 Updates

Checking for Updates

Log into your purchase portal
Download latest version if available
Extract and replace files
Test with your existing applications

Update Best Practices

✅ Backup your current project before updating
✅ Test updates in development environment first
✅ Review changelog for breaking changes
✅ Update dependencies if required

---

🆘 Getting Help

Support Channels

📧 Email Support: support@wigleystudios.com
📖 Documentation: Included with your purchase
🌐 Website: https://wigleystudios.com
💬 Community Forum: https://forum.wigleystudios.com

When Contacting Support

Please include:

Your license type and purchase information
Python version (python --version)
Operating system and version
Complete error message (if any)
Minimal code example demonstrating the issue

Response Times

Standard License: 2-3 business days
Professional License: 1-2 business days
Enterprise License: Same day (business hours)

---

🎉 You're Ready!

Congratulations! Your Bravura is now installed and ready for professional development.

Next Steps

📚 Read the Getting Started Guide
🔍 Explore the API Reference
🎮 Check out the demos in Bravura Demos and Templates/ directory
🚀 Start building your professional application!

Happy coding! 🎯

---