Skip to content

CrazyNeil/OllamaSpring

Repository files navigation

OllamaSpring

OllamaSpring is a comprehensive macOS client for managing the various models offered by the Ollama community (now with support for Groq API services), and for creating conversational AI experiences. This is an open-source and free software project, and we welcome users and developers to participate.

  • Supports all Ollama Models
  • Stream Response Control
  • Model Download and Deletion
  • Conversation and History Contexts
  • Customizable Response Language
  • Automatic Updates for OllamaSpring
  • Quick Installation by Entering Model Name
  • Image, PDF, and TXT File Input
  • Model Option Modifications
  • Quick Completion Feature
  • Groq Fast API Support
  • HTTP Proxy Configuration

Visit our website: https://www.ollamaspring.com

ollamaSpring-main jpg

New Features

Groq Fast API

If your Mac is not powerful enough to run the Ollama open-source models locally, you can now use the Groq Fast API service. All you need is a Groq API key to experience fast access to large open-source models.

ollamaSpring-main jpg

HTTP Proxy

If your network accesses the internet through an HTTP proxy, you can now configure it using the HTTP Proxy feature in OllamaSpring (available in the toolbar).

Quick Completion

Quick Completion allows you to send prompts quickly by activating it with cmd + shift + h. Update OllamaSpring to v1.1.5+ or install it from the Releases section.

ollamaSpring-main jpg

Download & Install

System Requirements:

  • macOS 14.0 or later
  • Ollama installed

Download the latest release package (v1.2.0) from the Releases section. Simply unzip the package and drag it into your Applications folder, or install the sandbox version (v1.1.4) from the App Store. Note: The sandbox version is subject to Apple App Store review. For the latest updates, we recommend using the binary installation package.

App Store

Run & Build

You can clone this project and build it using Xcode 14 or later.

Setup Update Server

OllamaSpring uses Sparkle as its built-in update framework. You need to make a few changes to set up your own update service.

1. Generate EdDSA Key

./bin/generate_keys

2. Setup Info.plist

3. Sandbox

OllamaSpring disables the sandbox in .entitlements. If you want to enable it, follow the Sparkle sandboxing guide.

4. Publish your appcast

Build your app, compress it (e.g. ZIP/tar.xz/DMG archive), and place the archive in a folder for storing future updates.

./bin/generate_appcast /path/to/your/updates_folder/

Upload your archives and appcast to your server.