Installation Guide
Complete installation instructions for CodaiPro across different environments and use cases.
Choose your installation method based on your needs: Portable executable for quick use, Python installation for development, or build from source for customization.
📋 System Requirements
Before installing CodaiPro, ensure your system meets these requirements:
Minimum Requirements
| Component | Requirement |
|---|---|
| Operating System | Windows 10 (64-bit) or later |
| Processor | Dual-core 2.0 GHz |
| RAM | 4 GB |
| Storage | 2 GB free disk space |
| Display | 1280 x 720 minimum resolution |
| Graphics | Integrated graphics (no GPU required) |
Recommended Requirements
| Component | Recommendation |
|---|---|
| Operating System | Windows 11 (64-bit) |
| Processor | Quad-core 2.5 GHz or higher |
| RAM | 8 GB or more |
| Storage | 4 GB free disk space (SSD preferred) |
| Display | 1920 x 1080 or higher |
| Graphics | Any modern GPU (optional, improves UI performance) |
Important: CodaiPro v2.1 is currently Windows-only. Mac and Linux support is planned for future releases.
🎯 Installation Methods
Choose the method that best fits your needs:
Method Comparison
| Method | Best For | Pros | Cons | Setup Time |
|---|---|---|---|---|
| Portable Executable | Students, Lab Use | No installation, USB-ready, No admin rights | Windows only | 2 minutes |
| Python Installation | Developers | Customizable, Cross-platform source | Requires Python | 5 minutes |
| Build from Source | Contributors | Full control, Latest features | Most complex | 15 minutes |
📦 Method 1: Portable Executable (Recommended)
Perfect for students, lab environments, and quick deployment.
Download the Portable Version
- Visit the CodaiPro Releases Page
- Locate the latest release (v2.1 or newer)
- Download CodaiPro-v2.1-Portable-Windows.zip
- File size: Approximately 500MB
For Lab Use: Download directly to a USB drive for maximum portability!
Extract the Archive
Windows Explorer
Using Windows Built-in Extractor:
- Right-click CodaiPro-v2.1-Portable-Windows.zip
- Select “Extract All…”
- Choose destination:
- Desktop:
C:\Users\[YourName]\Desktop\CodaiPro - USB Drive:
E:\CodaiPro(adjust drive letter) - Custom folder: Your preferred location
- Desktop:
- Check “Show extracted files when complete”
- Click Extract
Verify File Structure
After extraction, your folder should contain:
- CodaiPro_v21.exe
- KILL_V21.bat
- TEST_V21.bat
- README.md
- codai-model.gguf
Do not separate files! CodaiPro requires all files in the same directory to function properly.
Run CodaiPro
- Navigate to the extracted folder
- Double-click CodaiPro_v21.exe
- Wait for initialization (10-30 seconds)
First-time Windows SmartScreen Warning:
If Windows SmartScreen appears:
- Click “More info”
- Click “Run anyway”
- This is normal for new executables
Installation Complete! CodaiPro should now be running. Skip to the First Launch section.
🐍 Method 2: Python Installation
For developers who want to run CodaiPro from source code.
Install Python
Ensure Python 3.11 or newer is installed:
Check Existing
Check if Python is installed:
python --versionShould show: Python 3.11.x or higher
If not installed or version is too old, proceed to download.
Install Git (Optional but Recommended)
Check Existing
git --versionIf Git is installed, proceed to next step.
Clone the Repository
Using Git
# Navigate to your preferred directory
cd C:\Projects
# Clone the repository
git clone https://github.com/luckyyaduvanshi/codaipro.git
# Enter the directory
cd codaiproInstall Dependencies
# Install required Python packages
pip install -r requirements.txtExpected packages:
- CustomTkinter (GUI framework)
- FastAPI (Backend server)
- Uvicorn (ASGI server)
- llama-cpp-python (AI engine)
- And other dependencies
Installation may take 2-5 minutes depending on your internet speed.
Run CodaiPro
python launcher.pyThe application should start and open the GUI window.
Python Installation Complete! You can now run CodaiPro by executing python launcher.py anytime.
🚀 First Launch
What to expect when running CodaiPro for the first time:
Startup Sequence
🔄 Checking for existing CodaiPro instances...
→ Verifying port 8000 availability
→ Checking Windows mutex locks
→ Scanning for process lockfiles
✅ No conflicts detected
🚀 Starting backend server...
→ Initializing FastAPI server
→ Binding to localhost:8000
→ Loading endpoints
⚙️ Loading AI model...
→ Reading model file: models/codai-model.gguf
→ Allocating memory: ~2-4GB
→ Initializing inference engine
🎨 Launching GUI...
→ Creating CustomTkinter window
→ Connecting to backend
→ Loading user preferences
✨ CodaiPro is ready!
→ Backend server: ✓ Running
→ AI model: ✓ Loaded
→ GUI: ✓ ActiveTotal startup time: 10-30 seconds (varies by system)
🎯 Next Steps
Installation Complete! 🎉 You’re ready to start coding with AI assistance. Proceed to the Quick Start Guide to learn the basics.