Skip to main content

​
Prerequisites

Before installing Parsaa, ensure your system meets the following requirements:
System Requirements: Parsaa is designed specifically for macOS and Xcode development environments.

​
macOS Requirements

  • macOS: 12.0 (Monterey) or later
  • RAM: 8GB minimum (16GB recommended for optimal performance)
  • Storage: 2GB available disk space
  • Internet: Stable connection for AI model downloads

​
Xcode Requirements

  • Xcode: 14.0 or later
  • Command Line Tools: Installed and up to date
  • Swift: 5.7 or later
  • iOS Deployment Target: 15.0 or later
Xcode Required: Parsaa requires Xcode to be installed and properly configured. The extension integrates directly with Xcode’s interface.

​
Installation Methods

​
Beta Installation (Coming Soon)

1

Download the Installer

Once you receive beta access:
  1. Check your email for the beta invitation
  2. Click the download link in the email
  3. The installer will be downloaded to your Downloads folder
2

Run the Installer

# Navigate to Downloads folder
cd ~/Downloads

# Make installer executable
chmod +x ParsaaInstaller.pkg

# Run the installer
sudo installer -pkg ParsaaInstaller.pkg -target /
You may be prompted for your administrator password during installation.
3

Launch Xcode

  1. Open Xcode
  2. Look for the Parsaa extension in the menu bar
  3. Click on the Parsaa icon to open the assistant panel
4

Sign In

  1. Enter your beta account credentials
  2. Complete the initial setup wizard
  3. Configure your preferences

​
Manual Installation (Advanced)

For developers who prefer manual installation:
Download the following components:
  • Parsaa Extension: Parsaa.xcplugin
  • AI Models: parsaa-models.zip
  • Configuration: parsaa-config.json
# Create Parsaa directory
mkdir -p ~/Library/Application\ Support/Parsaa

# Copy extension to Xcode plugins
cp Parsaa.xcplugin ~/Library/Developer/Xcode/Plug-ins/

# Extract AI models
unzip parsaa-models.zip -d ~/Library/Application\ Support/Parsaa/
  1. Restart Xcode completely
  2. Go to Xcode > Preferences > Extensions
  3. Enable the Parsaa extension
  4. Grant necessary permissions

​
Post-Installation Setup

​
Initial Configuration

1

Account Setup

  1. Launch Xcode
  2. Open the Parsaa panel (View > Parsaa)
  3. Sign in with your beta account
  4. Complete the onboarding wizard
2

Project Integration

  1. Open your iOS project in Xcode
  2. Navigate to File > Project Settings
  3. Enable Parsaa integration for your project
  4. Configure AI model preferences
3

Test Installation

// Test Parsaa integration
import Foundation

class TestParsaa {
    func testAI() {
        // Select this code and try Chat with Code
        let message = "Hello, Parsaa!"
        print(message)
    }
}
If you can see Parsaa suggestions for the above code, installation was successful!

​
Configuration Options

Configure your preferred AI model:
  • Cloud Models: OpenAI GPT-4, Claude, etc.
  • Local Models: Ollama, LM Studio (coming soon)
  • Hybrid Mode: Combine cloud and local processing
Choose your privacy level:
  • Full Privacy: All processing done locally
  • Balanced: Sensitive code local, general queries cloud
  • Performance: All processing in cloud for speed
Customize Parsaa’s behavior:
  • Auto-suggestions: Enable/disable automatic code suggestions
  • Chat frequency: How often to show chat suggestions
  • Code analysis: Depth of code analysis and suggestions

​
Troubleshooting

​
Common Issues

Solution:
  1. Restart Xcode completely
  2. Check Xcode > Preferences > Extensions
  3. Ensure Parsaa is enabled
  4. Try reinstalling the extension
Solution:
# Grant necessary permissions
sudo chmod +x ~/Library/Developer/Xcode/Plug-ins/Parsaa.xcplugin
sudo xattr -r -d com.apple.quarantine ~/Library/Developer/Xcode/Plug-ins/Parsaa.xcplugin
Solution:
  1. Check internet connection
  2. Verify model download completed
  3. Restart Parsaa extension
  4. Check available disk space
Solution:
  1. Update Xcode to latest version
  2. Update Command Line Tools
  3. Check macOS version compatibility
  4. Contact support if issues persist

​
Uninstallation

To remove Parsaa completely:
1

Remove Extension

# Remove Parsaa extension
rm -rf ~/Library/Developer/Xcode/Plug-ins/Parsaa.xcplugin

# Remove application data
rm -rf ~/Library/Application\ Support/Parsaa
rm -rf ~/Library/Preferences/com.parsaa.*
2

Clean Xcode

  1. Restart Xcode
  2. Clear Xcode derived data
  3. Reset Xcode preferences if needed

​
Support

Get Help

Having trouble with installation? Our support team is here to help.
Beta Support: During the beta period, we provide priority support for all installation and setup issues.