Desktop Setup
Use this guide when you want to run OCI Policy Analysis as a desktop application (Tkinter).
Choose Desktop Setup When
You want a local, single-user workflow.
You prefer the full tabbed desktop UI.
You do not need browser/server deployment.
Installation Options
Option A: Platform executable (no Python required)
Go to the GitHub releases page.
Download the latest build for your platform:
Windows:
.exeinstallermacOS:
.appbundle (possibly in.zip/.dmg)
Launch the app normally from your OS.
Option B: Run from source (recommended for development)
1) Verify Python version
Desktop/source runs require Python 3.12+.
python3 -V
2) Verify Tkinter availability
python3 - << 'EOF'
import tkinter
print("Tkinter is available.")
EOF
If missing:
Linux (Debian/Ubuntu):
sudo apt-get install -y python3-tkmacOS/Windows: prefer official Python installer from python.org.
3) Create and activate virtual environment
git clone https://github.com/agregory999/oci-policy-analysis.git
cd oci-policy-analysis
python3 -m venv .venv
source .venv/bin/activate
Windows PowerShell:
py -3.12 -m venv .venv
.venv\Scripts\activate
4) Install and run desktop mode
python -m pip install --upgrade pip
pip install -e .
python -m oci_policy_analysis.main
Helper Scripts (optional)
macOS/Linux:
./local-build.sh --mode desktop
./local-run.sh --mode desktop
Windows PowerShell:
./local-build.ps1 --mode desktop
./local-run.ps1 --mode desktop
Permissions & Authentication
Desktop mode uses the same OCI permissions/authentication models as other modes:
Named OCI profile
Instance principal
Session token
For complete policy statements and auth details, see setup_web.md (shared across modes).
Troubleshooting (Desktop)
Tkinter import failures: confirm OS Tk package / python.org build.
Python mismatch: use Python 3.12+.
Dependency issues: re-activate
.venv, reinstall withpip install -e ..