Bravura SDK Installation Guide

Modern, accurate instructions for installing the Bravura SDK, activating licenses, and verifying everything works.

---

1. System Requirements

Component	Requirement
Python	3.9 – 3.13 (64-bit, CPython)
OS	Windows 10/11 (Enterprise source install can target Linux/macOS)
Memory	4 GB minimum (8 GB recommended)
Disk	2 GB free (demos + source)
GUI	tkinter (bundled with CPython for Windows)

Optional pip packages:


pip install pygame Pillow GPUtil psutil

These unlock premium animations, GPU detection, and richer media handling for Professional+ tiers.

---

2. Unpack the Customer Package

Download your tier ZIP from the customer portal.
Extract it to a short path without spaces (e.g. C:\Bravura\).
Inside you’ll see a folder similar to Bravura-Professional-Edition-v1.0.0:

- wheels/ – Pre-built Windows wheels for Python 3.9–3.13

- docs/ – All guides including this file

- demos/ + templates/ – Ready-to-run examples

- license-helpers/ – Activation, diagnostics, deactivation scripts

- licenses/ – Commercial license + activation reference

- QUICKSTART_GUIDE.md – Demo catalog

- README.md – Tier-specific overview

- src/ + build files (Enterprise only)

---

3. Install the SDK Wheel (Standard & Professional)

> Enterprise customers should follow Section 4 if installing from source; you can still install a wheel first for convenience.

Step 1 – Confirm Python version


python --version

Ensure it matches one of the provided wheels (3.9–3.13, 64-bit).

Step 2 – Activate/enter a virtual environment (recommended)


python -m venv bravura-env
bravura-env\Scripts\activate

Step 3 – Install the matching wheel


cd "C:\Bravura\Bravura-Professional-Edition-v1.0.0\wheels"
pip install bravura_professional-1.0.0-cp311-cp311-win_amd64.whl

> Wheel naming guide: cp39 → Python 3.9, cp310 → 3.10, etc. Installing a mismatched wheel results in Unsupported wheel errors—always match exactly.

Step 4 – Verify import


python -c "import bravura; print('Bravura SDK ready!')"

If this prints without errors, the SDK is installed.

---

4. Enterprise Source/Editable Install

Enterprise tier folders include full source code plus build metadata.

Complete the wheel installation above (fastest way to get dependencies).
From the package root:


cd "C:\Bravura\Bravura-Enterprise-Edition-v1.0.0"
pip install -r requirements.txt            # Install extras
pip install -e .                           # Editable install

Optional production build:


pip install .

Editable installs let you modify src/bravura/ and see changes instantly. Remember to re-run your test suite before packaging customer builds.

---

5. Activate the License

Guided helper (all tiers)


cd ..\license-helpers
python activate_license.py

Enter the license key + email from your fulfillment email.
The helper contacts the licensing API, stores the activation locally, and prints seat info plus expiration.

Manual programmatic activation


from bravura import licensing

manager = licensing.LicenseManager()
manager.activate_license(
    license_key="YOUR-LICENSE-KEY",
    email="your@email.com",
)

Seat limits

Tier	Concurrent machine activations
Standard	1
Professional	5
Enterprise	25

Free a seat by running license_deactivation_demo.py on the old machine.
test_license_info.py shows current status, tier, and expiration.
Clearing the cache with clear_license_cache.py does not free seats—always deactivate first.

---

6. Verify the Installation


# verify_bravura.py
from bravura import get_audio_analyzer_framework

AppClass = get_audio_analyzer_framework()
app = AppClass()

print("✅ Framework imported")
# app.run()  # optional GUI launch

Or run any tier demo:


cd ..\demos
python professional_analysis_terminal_demo.py

You should see the Bravura GUI with real-time logging, premium buttons, progress bars, and tier-specific components.

---

7. Optional Dependencies & Performance Extras


pip install pygame Pillow GPUtil psutil

pygame: audio cues + polished loading animation loops
Pillow: high-quality image processing
GPUtil: GPU detection + utilization overlays
psutil: detailed system stats for dashboards

These packages are optional but strongly recommended for Professional/Enterprise demos.

---

8. Troubleshooting

Symptom	Fix
`ERROR: bravura_standard... is not supported on this platform`	Install the wheel matching your Python version and 64-bit build.
`ModuleNotFoundError: bravura`	Ensure the virtual environment is activated before running Python, then re-run `pip install` from `wheels/`.
License activation stuck at “validating”	Check your firewall/proxy allows HTTPS to `licensing.wigleystudios.com`. Retry with `activate_license.py`.
“Activation limit reached”	Run `license_deactivation_demo.py` on unused machines or email support with your key + machine ID.
Tkinter missing on Linux/macOS	Install `python3-tk` (Linux) or use the CPython installer for macOS that bundles Tcl/Tk.
GUI text blurry on high DPI monitors	Call `ctypes.windll.shcore.SetProcessDpiAwareness(1)` before creating the Tk root window.
Wheel installs but demos fail with missing modules	Install the optional dependencies above and restart Python.

For deeper scenarios read docs/TROUBLESHOOTING.md.

---

9. Packaging Your Own Application


pip install pyinstaller
pyinstaller --noconfirm --onefile --windowed main.py

Include extra resources using --add-data "assets;assets" and ship your own license terms. For cx_Freeze, refer to docs/INTEGRATION_GUIDE.md.

Checklist before distributing:

Test on a clean VM with only CPython installed.
Bundle your own license terms (Bravura license covers SDK usage, not your app).
Never redistribute Bravura source unless you own an Enterprise Perpetual license (see commercial license for details).

---

10. Updates

Download the latest ZIP from the portal.
Compare CHANGELOG.md.
Replace the wheels/ folder or reinstall from source.
Re-run activate_license.py only if switching machines; existing activations remain valid.

---

11. Getting Help

Support: support@wigleystudios.com (include license key, machine ID, Python version, and logs)
Sales & upgrades: sales@wigleystudios.com
Docs: https://wigleystudios.com/docs
Community: https://wigleystudios.com/community

Response-time SLA: Standard ≤24h, Professional ≤12h, Enterprise ≤4h during business hours.

---

You’re ready to build with Bravura. Continue to docs/GETTING_STARTED.md for component imports, tier-specific capabilities, and best practices.