Home / Docs / Quick Start

Quick Start Guide

Get KeisenVPA running in under 10 minutes

On This Page

Requirements

Before you begin, make sure you have the following:

Requirement Minimum Recommended
Operating System macOS 11+, Ubuntu 20.04+, Windows 10+ macOS 13+, Ubuntu 22.04+
Python 3.9+ 3.11+
RAM 4 GB 8 GB+
Disk Space 500 MB 2 GB (for Whisper models)
💡
Whisper Model Size
The large-v3 Whisper model provides the best accuracy but requires ~3GB of disk space and more RAM. For faster performance with less resources, start with the base or small model.

Installation

Follow these steps to install KeisenVPA on your system:

Clone the repository

Download the KeisenVPA source code from our Git server:

bash 
git clone https://git.keisen.ai/keisenvpa/keisenvpa.git
cd keisenvpa

Create a virtual environment

Isolate your Python dependencies (recommended):

bash 
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies

Install all required Python packages:

bash 
pip install -r requirements.txt

Verify installation

Make sure everything installed correctly:

bash 
python -c "import PyQt6; import anthropic; print('✓ All dependencies installed!')"

API Setup

KeisenVPA uses Claude for AI-powered document generation. You'll need an Anthropic API key:

  1. Visit console.anthropic.com
  2. Create an account or sign in
  3. Navigate to API Keys and generate a new key
  4. Set your API key as an environment variable:
bash 
# Add to your shell profile (.zshrc, .bashrc, etc.)
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# Apply the change
source ~/.zshrc  # or ~/.bashrc
⚠️
Keep your API key secure
Never commit your API key to version control or share it publicly. KeisenVPA stores the key securely and never logs it.

Your First Transcription

Now you're ready to launch KeisenVPA and process your first transcription:

bash 
python main_window.py

The KeisenVPA window will open. Here's what to do next:

  1. Load transcription files: Click "Load Transcription Files" and select a .txt file containing transcribed audio
  2. Review the content: The transcription appears in the left panel
  3. Generate a document: Click "Generate H&P" or "Generate SOAP Note" for medical workflows, or type a custom prompt
  4. Copy or save: Use the copy button to grab the output, or save the conversation for later
✅
You're all set!
You've successfully installed KeisenVPA and processed your first transcription. Continue to the next section to learn about advanced features.

Next Steps

Now that you have KeisenVPA running, explore these topics:

← Previous
Home
Next →
Full Installation Guide