|

Docs

Desktop Installation

HammerAI is available for download through the official GitHub repository, where users can access both the latest stable release and pre-release (beta) versions for testing. 

Where to Download HammerAI

You can download here: https://www.hammerai.com/desktop

Installation Instructions

After downloading HammerAI, run the installer executable.

On Windows, because of code-signing limitations, a security prompt may appear. This is because HammerAI does not generate enough revenue to afford an officially signed certificate. Instead, we've used a private code-signing certificate for security. Click "More Info" and select "Run Anyway" to continue the installation.

Common Installation Issues

The installation gets stuck on a loading screen

In some cases, the installation may hang or close unexpectedly before completion. Typically, HammerAI installs within a few minutes, so if the installer appears stuck, follow these steps:

  1. Close the Installer Manually – If the installer does not close itself, close the window.
  2. Run HammerAI – The program is likely installed and can launch from the desktop icon.
  3. Verify Installation – If the app does not start, attempt a reinstallation.
HammerAI doesn't open after installation

If the application fails to start after installation, some processes may become stuck.

One fix is to terminate stuck processes via Task Manager using these streps:

  1. Close HammerAI completely.
  2. Press Ctrl + Shift + Esc to open Task Manager.
  3. Navigate to the Details tab.
  4. Locate any processes named "Ollama" or "Hammer".
  5. Right-click each process and select "End Process".
  6. Once all related processes have been terminated, restart HammerAI.

If manually ending processes does not resolve the issue, restarting your computer may fix the issue.

Handling Network Permission Prompts

On Windows, after starting HammerAI for the first time, users will encounter a network permission request. This is normal and required for the local execution of language models.

  • HammerAI spins up a local server using a random port to handle AI processing.
  • Users only need to allow internal network requests, not public network access.

Directory & File Locations

HammerAI is not currently portable and is installed to a default system location. However, users can specify an alternative directory for saving local LLMs to. This can be configured on the Models page of HammerAI Desktop.

On Windows, HammerAI is installed in two locations:

  • Primary Installation Folder (Main Program Files): This folder contains the main executable files for HammerAI.
C:\Users\<your-username>\AppData\Local\HammerAI\
  • User Data, Models, and Configurations: This folder stores models, settings, and configuration data.
C:\Users\<your-username>\AppData\Roaming\HammerAI\

Uninstalling HammerAI

HammerAI does not have an official uninstaller, but the development team is actively working on implementing one in a future update. In the meantime, users can follow a manual uninstallation process to remove all application files from their system.

On Windows, delete the following directories:

  • Primary Installation Folder (Main Program Files) 
C:\Users\<your-username>\AppData\Local\HammerAI\
  • User Data, Models, and Configurations 
C:\Users\<your-username>\AppData\Roaming\HammerAI\

Updating HammerAI

HammerAI will automatically download new app versions for you. Occasionally, users may experience difficulties with application updates. If HammerAI is not updating properly, leaving the application open for five to ten minutes before closing and reopening often resolves the issue. If that doesn't work, you can manually download a new release from https://github.com/hammer-ai/hammerai/releases.