ContextCraft is available for both macOS and Windows platforms. Follow the instructions below for your specific operating system to get started.

There are two methods to install ContextCraft on macOS:

1. Download the latest .dmg file from the Releases page.
2. Double-click the downloaded .dmg file to mount the disk image.
3. Drag the ContextCraft application to your Applications folder.
4. When first launching the app, you may encounter a security warning since ContextCraft is not signed with an Apple Developer Certificate.

To resolve this security warning:

• Right-click (or Control-click) ContextCraft in the Applications folder
• Select "Open" from the context menu
• Click "Open" in the security dialog that appears
• You only need to perform this step once; subsequent launches will work normally

Alternatively, you can:

1. Open System Settings
2. Go to Privacy & Security
3. Scroll down to the "Security" section
4. Click "Open Anyway" next to the message about ContextCraft

If you encounter issues with the DMG method:

1. Download the latest ContextCraft-[version]-arm64-mac.zip from the Releases page.
2. Double-click to extract the ZIP file.
3. Drag the extracted ContextCraft app to your Applications folder.
4. Follow the same security bypass steps as with the DMG version.

Apple requires apps to be signed with an Apple Developer Certificate ($99/year) and notarized for best security. ContextCraft is distributed without this certification to keep it free and open source. The app is still safe to use; you're simply bypassing Apple's verification system.

Click to see what to expect during installation

1. Initial Security Warning:

   "ContextCraft" cannot be opened because the developer cannot be verified.
   macOS cannot verify that this app is free from malware.
   

2. Opening from Context Menu:

   • Right-click menu will show "Open" option
   • A dialog will appear with an "Open" button

3. Privacy & Security Settings:

   • Look for the message: "ContextCraft was blocked from use because it is not from an identified developer"
   • Click "Open Anyway" button

Note: These screenshots are from macOS Sonoma. The exact appearance might vary slightly depending on your macOS version.

ContextCraft provides two installation options for Windows users:

1. Download ContextCraft-[version]-x64-setup.exe from the Releases page.
2. Double-click the installer file.
3. Follow the installation wizard's instructions.
4. The app will be installed in your Program Files directory.
5. Launch ContextCraft from the Start Menu or desktop shortcut.

For users who prefer not to install applications:

1. Download ContextCraft-[version]-x64-portable.exe from the Releases page.
2. Move the .exe file to your preferred location.
3. Double-click to run directly - no installation needed.
4. This version can be moved between computers or run from a USB drive.

When running for the first time, Windows may show a SmartScreen warning:

1. Click "More info"
2. Click "Run anyway"

This happens because the app isn't signed with a Microsoft certificate, which is common for many legitimate applications.

• macOS 10.15 (Catalina) or later
• 4GB RAM minimum (8GB recommended)
• 200MB free disk space
• Both Intel and Apple Silicon (M1/M2/M3) processors supported

• Windows 10 or later (64-bit)
• 4GB RAM minimum (8GB recommended)
• 200MB free disk space
• Intel or AMD 64-bit processor

• Active internet connection (for model information updates)
• Modern web browser engine (included with the application)
• Permission to access local files

---

Next Steps: After installing ContextCraft, check out the Quick Start guide to begin using the application.