Running StarVault

Standalone Executable (Windows)

• Double-click StarVault.exe in the project root or in dist/StarVault.exe.
• Zero console window: Runs cleanly with custom icon embedding without popping up a command prompt.
• Portable mode: Place starvault.db in the same directory to run in fully portable mode.

Running from Source

# 1. Clone repository
git clone https://github.com/blivodev/StarVault.git
cd StarVault

# 2. Set up virtual environment
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# 3. Install dependencies
pip install -r requirements.txt

# 4. Launch StarVault
python run.py

Launch Flags

• Default Mode (uses %LOCALAPPDATA%\StarVault\starvault.db): python run.py
• Portable Mode (uses ./starvault.db in working directory): python run.py --portable
• Custom Database: python run.py --db "D:/Secure/vault.db"

---