Skip to content

AIComputerServices/olion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4,910 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

  ollama

Olion

Get up and running with large language models.

macOS

Download

Windows

Download

Linux

curl -fsSL https://ollama.com/install.sh | sh

Manual install instructions

Docker

The official Olion Docker image ollama/ollama is available on Docker Hub.

Libraries

Community

Quickstart

To run and chat with Gemma 3:

olion run gemma3

Model library

Olion supports a list of models available on ollama.com/library

Here are some example models that can be downloaded:

Model Parameters Size Download
Gemma 3 1B 815MB olion run gemma3:1b
Gemma 3 4B 3.3GB olion run gemma3
Gemma 3 12B 8.1GB olion run gemma3:12b
Gemma 3 27B 17GB olion run gemma3:27b
QwQ 32B 20GB olion run qwq
DeepSeek-R1 7B 4.7GB olion run deepseek-r1
DeepSeek-R1 671B 404GB olion run deepseek-r1:671b
Llama 4 109B 67GB olion run llama4:scout
Llama 4 400B 245GB olion run llama4:maverick
Llama 3.3 70B 43GB olion run llama3.3
Llama 3.2 3B 2.0GB olion run llama3.2
Llama 3.2 1B 1.3GB olion run llama3.2:1b
Llama 3.2 Vision 11B 7.9GB olion run llama3.2-vision
Llama 3.2 Vision 90B 55GB olion run llama3.2-vision:90b
Llama 3.1 8B 4.7GB olion run llama3.1
Llama 3.1 405B 231GB olion run llama3.1:405b
Phi 4 14B 9.1GB olion run phi4
Phi 4 Mini 3.8B 2.5GB olion run phi4-mini
Mistral 7B 4.1GB olion run mistral
Moondream 2 1.4B 829MB olion run moondream
Neural Chat 7B 4.1GB olion run neural-chat
Starling 7B 4.1GB olion run starling-lm
Code Llama 7B 3.8GB olion run codellama
Llama 2 Uncensored 7B 3.8GB olion run llama2-uncensored
LLaVA 7B 4.5GB olion run llava
Granite-3.3 8B 4.9GB olion run granite3.3

Note

You should have at least 8 GB of RAM available to run the 7B models, 16 GB to run the 13B models, and 32 GB to run the 33B models.

Customize a model

Import from GGUF

Olion supports importing GGUF models in the Modelfile:

  1. Create a file named Modelfile, with a FROM instruction with the local filepath to the model you want to import.

    FROM ./vicuna-33b.Q4_0.gguf
    
  2. Create the model in Olion

    olion create example -f Modelfile
  3. Run the model

    olion run example

Import from Safetensors

See the guide on importing models for more information.

Customize a prompt

Models from the Olion library can be customized with a prompt. For example, to customize the llama3.2 model:

olion pull llama3.2

Create a Modelfile:

FROM llama3.2

# set the temperature to 1 [higher is more creative, lower is more coherent]
PARAMETER temperature 1

# set the system message
SYSTEM """
You are Mario from Super Mario Bros. Answer as Mario, the assistant, only.
"""

Next, create and run the model:

olion create mario -f ./Modelfile
olion run mario
>>> hi
Hello! It's your friend Mario.

For more information on working with a Modelfile, see the Modelfile documentation.

CLI Reference

Create a model

olion create is used to create a model from a Modelfile.

olion create mymodel -f ./Modelfile

Pull a model

olion pull llama3.2

This command can also be used to update a local model. Only the diff will be pulled.

Remove a model

olion rm llama3.2

Copy a model

olion cp llama3.2 my-model

Multiline input

For multiline input, you can wrap text with """:

>>> """Hello,
... world!
... """
I'm a basic program that prints the famous "Hello, world!" message to the console.

Multimodal models

olion run llava "What's in this image? /Users/jmorgan/Desktop/smile.png"

Output: The image features a yellow smiley face, which is likely the central focus of the picture.

Pass the prompt as an argument

olion run llama3.2 "Summarize this file: $(cat README.md)"

Output: Olion is a lightweight, extensible framework for building and running language models on the local machine. It provides a simple API for creating, running, and managing models, as well as a library of pre-built models that can be easily used in a variety of applications.

Show model information

olion show llama3.2

List models on your computer

olion list

List which models are currently loaded

olion ps

Stop a model which is currently running

ollama stop llama3.2

Generate embeddings from the CLI

olion run embeddinggemma "Your text to embed"

You can also pipe text for scripted workflows:

echo "Your text to embed" | olion run embeddinggemma

Start Olion

olion serve is used when you want to start ollama without running the desktop application.

Building

See the developer guide

Running local builds

Next, start the server:

./olion serve

Finally, in a separate shell, run a model:

./olion run llama3.2

REST API

Olion has a REST API for running and managing models.

Generate a response

curl http://localhost:11434/api/generate -d '{
  "model": "llama3.2",
  "prompt":"Why is the sky blue?"
}'

Chat with a model

curl http://localhost:11434/api/chat -d '{
  "model": "llama3.2",
  "messages": [
    { "role": "user", "content": "why is the sky blue?" }
  ]
}'

See the API documentation for all endpoints.

Community Integrations

Web & Desktop

  • Open WebUI
  • SwiftChat (macOS with ReactNative)
  • Enchanted (macOS native)
  • Hollama
  • Lollms WebUI (Single user)
  • Lollms (Multi users)
  • LibreChat
  • Bionic GPT
  • HTML UI
  • AI-UI
  • Saddle
  • TagSpaces (A platform for file-based apps, utilizing Olion for the generation of tags and descriptions)
  • Chatbot UI
  • Chatbot UI v2
  • Typescript UI
  • Minimalistic React UI for Olion Models
  • Olionc
  • big-AGI
  • Cheshire Cat assistant framework
  • Amica
  • chatd
  • Olion-SwiftUI
  • Dify.AI
  • MindMac
  • NextJS Web Interface for Olion
  • Msty
  • Chatbox
  • WinForm Olion Copilot
  • NextChat with Get Started Doc
  • Alpaca WebUI
  • OlionGUI
  • OpenAOE
  • Odin Runes
  • LLM-X (Progressive Web App)
  • AnythingLLM (Docker + MacOs/Windows/Linux native app)
  • Olion Basic Chat: Uses HyperDiv Reactive UI
  • Olion-chats RPG
  • IntelliBar (AI-powered assistant for macOS)
  • Jirapt (Jira Integration to generate issues, tasks, epics)
  • ojira (Jira chrome plugin to easily generate descriptions for tasks)
  • QA-Pilot (Interactive chat tool that can leverage Olion models for rapid understanding and navigation of GitHub code repositories)
  • ChatOlion (Open Source Chatbot based on Olion with Knowledge Bases)
  • CRAG Olion Chat (Simple Web Search with Corrective RAG)
  • RAGFlow (Open-source Retrieval-Augmented Generation engine based on deep document understanding)
  • StreamDeploy (LLM Application Scaffold)
  • chat (chat web app for teams)
  • Lobe Chat with Integrating Doc
  • Olion RAG Chatbot (Local Chat with multiple PDFs using Olion and RAG)
  • BrainSoup (Flexible native client with RAG & multi-agent automation)
  • macai (macOS client for Olion, ChatGPT, and other compatible API back-ends)
  • RWKV-Runner (RWKV offline LLM deployment tool, also usable as a client for ChatGPT and Olion)
  • Olion Grid Search (app to evaluate and compare models)
  • Olpaka (User-friendly Flutter Web App for Olion)
  • Casibase (An open source AI knowledge base and dialogue system combining the latest RAG, SSO, ollama support, and multiple large language models.)
  • OlionSpring (Olion Client for macOS)
  • LLocal.in (Easy to use Electron Desktop Client for Olion)
  • Shinkai Desktop (Two click install Local AI using Olion + Files + RAG)
  • AiLama (A Discord User App that allows you to interact with Olion anywhere in Discord)
  • Olion with Google Mesop (Mesop Chat Client implementation with Olion)
  • R2R (Open-source RAG engine)
  • Olion-Kis (A simple easy-to-use GUI with sample custom LLM for Drivers Education)
  • OpenGPA (Open-source offline-first Enterprise Agentic Application)
  • Painting Droid (Painting app with AI integrations)
  • Kerlig AI (AI writing assistant for macOS)
  • AI Studio
  • Sidellama (browser-based LLM client)
  • LLMStack (No-code multi-agent framework to build LLM agents and workflows)
  • BoltAI for Mac (AI Chat Client for Mac)
  • Harbor (Containerized LLM Toolkit with Olion as default backend)
  • PyGPT (AI desktop assistant for Linux, Windows, and Mac)
  • Alpaca (An Olion client application for Linux and macOS made with GTK4 and Adwaita)
  • AutoGPT (AutoGPT Olion integration)
  • Go-CREW (Powerful Offline RAG in Golang)
  • PartCAD (CAD model generation with OpenSCAD and CadQuery)
  • Olion4j Web UI - Java-based Web UI for Olion built with Vaadin, Spring Boot, and Olion4j
  • PyOllaMx - macOS application capable of chatting with both Olion and Apple MLX models.
  • Cline - Formerly known as Claude Dev is a VS Code extension for multi-file/whole-repo coding
  • Void (Open source AI code editor and Cursor alternative)
  • Cherry Studio (Desktop client with Olion support)
  • ConfiChat (Lightweight, standalone, multi-platform, and privacy-focused LLM chat interface with optional encryption)
  • Archyve (RAG-enabling document library)
  • crewAI with Mesop (Mesop Web Interface to run crewAI with Olion)
  • Tkinter-based client (Python tkinter-based Client for Olion)
  • LLMChat (Privacy focused, 100% local, intuitive all-in-one chat interface)
  • Local Multimodal AI Chat (Olion-based LLM Chat with support for multiple features, including PDF RAG, voice chat, image-based interactions, and integration with OpenAI.)
  • ARGO (Locally download and run Olion and Huggingface models with RAG and deep research on Mac/Windows/Linux)
  • OrionChat - OrionChat is a web interface for chatting with different AI providers
  • G1 (Prototype of using prompting strategies to improve the LLM's reasoning through o1-like reasoning chains.)
  • Web management (Web management page)
  • Promptery (desktop client for Olion.)
  • Olion App (Modern and easy-to-use multi-platform client for Olion)
  • chat-ollama (a React Native client for Olion)
  • SpaceLlama (Firefox and Chrome extension to quickly summarize web pages with ollama in a sidebar)
  • YouLama (Webapp to quickly summarize any YouTube video, supporting Invidious as well)
  • DualMind (Experimental app allowing two models to talk to each other in the terminal or in a web interface)
  • ollamarama-matrix (Olion chatbot for the Matrix chat protocol)
  • ollama-chat-app (Flutter-based chat app)
  • Perfect Memory AI (Productivity AI assists personalized by what you have seen on your screen, heard, and said in the meetings)
  • Hexabot (A conversational AI builder)
  • Reddit Rate (Search and Rate Reddit topics with a weighted summation)
  • OpenTalkGpt (Chrome Extension to manage open-source models supported by Olion, create custom models, and chat with models from a user-friendly UI)
  • VT (A minimal multimodal AI chat app, with dynamic conversation routing. Supports local models via Olion)
  • Nosia (Easy to install and use RAG platform based on Olion)
  • Witsy (An AI Desktop application available for Mac/Windows/Linux)
  • Abbey (A configurable AI interface server with notebooks, document storage, and YouTube support)
  • Minima (RAG with on-premises or fully local workflow)
  • aidful-ollama-model-delete (User interface for simplified model cleanup)
  • Perplexica (An AI-powered search engine & an open-source alternative to Perplexity AI)
  • Olion Chat WebUI for Docker (Support for local docker deployment, lightweight ollama webui)
  • AI Toolkit for Visual Studio Code (Microsoft-official VS Code extension to chat, test, evaluate models with Olion support, and use them in your AI applications.)
  • MinimalNextOlionChat (Minimal Web UI for Chat and Model Control)
  • Chipper AI interface for tinkerers (Olion, Haystack RAG, Python)
  • ChibiChat (Kotlin-based Android app to chat with Olion and Koboldcpp API endpoints)
  • LocalLLM (Minimal Web-App to run ollama models on it with a GUI)
  • Olionzing (Web extension to run Olion models)
  • OpenDeepResearcher-via-searxng (A Deep Research equivalent endpoint with Olion support for running locally)
  • AntSK (Out-of-the-box & Adaptable RAG Chatbot)
  • MaxKB (Ready-to-use & flexible RAG Chatbot)
  • yla (Web interface to freely interact with your customized models)
  • LangBot (LLM-based instant messaging bots platform, with Agents, RAG features, supports multiple platforms)
  • 1Panel (Web-based Linux Server Management Tool)
  • AstrBot (User-friendly LLM-based multi-platform chatbot with a WebUI, supporting RAG, LLM agents, and plugins integration)
  • Reins (Easily tweak parameters, customize system prompts per chat, and enhance your AI experiments with reasoning model support.)
  • Flufy (A beautiful chat interface for interacting with Olion's API. Built with React, TypeScript, and Material-UI.)
  • Ellama (Friendly native app to chat with an Olion instance)
  • screenpipe Build agents powered by your screen history
  • Ollamb (Simple yet rich in features, cross-platform built with Flutter and designed for Olion. Try the web demo.)
  • Writeopia (Text editor with integration with Olion)
  • AppFlowy (AI collaborative workspace with Olion, cross-platform and self-hostable)
  • Lumina (A lightweight, minimal React.js frontend for interacting with Olion servers)
  • Tiny Notepad (A lightweight, notepad-like interface to chat with ollama available on PyPI)
  • macLlama (macOS native) (A native macOS GUI application for interacting with Olion models, featuring a chat interface.)
  • GPTranslate (A fast and lightweight, AI powered desktop translation application written with Rust and Tauri. Features real-time translation with OpenAI/Azure/Olion.)
  • ollama launcher (A launcher for Olion, aiming to provide users with convenient functions such as olion server launching, management, or configuration.)
  • ai-hub (AI Hub supports multiple models via API keys and Chat support via Olion API.)
  • Mayan EDMS (Open source document management system to organize, tag, search, and automate your files with powerful Olion driven workflows.)
  • Serene Pub (Beginner friendly, open source AI Roleplaying App for Windows, Mac OS and Linux. Search, download and use models with Olion all inside the app.)
  • Andes (A Visual Studio Code extension that provides a local UI interface for Olion models)
  • KDeps (Kdeps is an offline-first AI framework for building Dockerized full-stack AI applications declaratively using Apple PKL and integrates APIs with Olion on the backend.)
  • Clueless (Open Source & Local Cluely: A desktop application LLM assistant to help you talk to anything on your screen using locally served Olion models. Also undetectable to screenshare)
  • ollama-co2 (FastAPI web interface for monitoring and managing local and remote Olion servers with real-time model monitoring and concurrent downloads)
  • Hillnote (A Markdown-first workspace designed to supercharge your AI workflow. Create documents ready to integrate with Claude, ChatGPT, Gemini, Cursor, and more - all while keeping your work on your device.)

Cloud

Tutorial

Terminal

Apple Vision Pro

  • SwiftChat (Cross-platform AI chat app supporting Apple Vision Pro via "Designed for iPad")
  • Enchanted

Database

  • pgai - PostgreSQL as a vector database (Create and search embeddings from Olion models using pgvector)
  • MindsDB (Connects Olion models with nearly 200 data platforms and apps)
  • chromem-go with example
  • Kangaroo (AI-powered SQL client and admin tool for popular databases)

Package managers

Libraries

Mobile

  • SwiftChat (Lightning-fast Cross-platform AI chat app with native UI for Android, iOS, and iPad)
  • Enchanted
  • Maid
  • Olion App (Modern and easy-to-use multi-platform client for Olion)
  • ConfiChat (Lightweight, standalone, multi-platform, and privacy-focused LLM chat interface with optional encryption)
  • Olion Android Chat (No need for Termux, start the Olion service with one click on an Android device)
  • Reins (Easily tweak parameters, customize system prompts per chat, and enhance your AI experiments with reasoning model support.)

Extensions & Plugins

Supported backends

  • llama.cpp project founded by Georgi Gerganov.

Observability

  • Opik is an open-source platform to debug, evaluate, and monitor your LLM applications, RAG systems, and agentic workflows with comprehensive tracing, automated evaluations, and production-ready dashboards. Opik supports native integration to Olion.
  • Lunary is the leading open-source LLM observability platform. It provides a variety of enterprise-grade features such as real-time analytics, prompt templates management, PII masking, and comprehensive agent tracing.
  • OpenLIT is an OpenTelemetry-native tool for monitoring Olion Applications & GPUs using traces and metrics.
  • HoneyHive is an AI observability and evaluation platform for AI agents. Use HoneyHive to evaluate agent performance, interrogate failures, and monitor quality in production.
  • Langfuse is an open source LLM observability platform that enables teams to collaboratively monitor, evaluate and debug AI applications.
  • MLflow Tracing is an open source LLM observability tool with a convenient API to log and visualize traces, making it easy to debug and evaluate GenAI applications.

Security

About

Get up and running with OpenAI gpt-oss, DeepSeek-R1, Gemma 3 and other models.

Resources

License

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors