arkiv

arkiv — Full Install Guide

Prerequisites

Dependency	macOS (brew)	Linux (apt)	Windows
Python 3.9+	brew install python	sudo apt install python3 python3-venv	python.org
FFmpeg 6.0+	brew install ffmpeg	sudo apt install ffmpeg	ffmpeg.org
Ollama	brew install ollama	ollama.com/download	ollama.com/download

---

macOS (brew + pip)

brew install python ffmpeg ollama
git clone https://github.com/vulture-s/arkiv.git && cd arkiv
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pip install mlx-whisper          # Apple Silicon
ollama pull bge-m3 && ollama pull qwen2.5vl:7b && ollama pull qwen2.5:14b   # + minicpm-v (optional vision fallback)
python health.py

Resolve plugin: Requires Python 3.10 Framework .pkg from python.org — Homebrew Python is not recognized by Resolve.

---

Linux (pip)

sudo apt install python3 python3-venv ffmpeg
git clone https://github.com/vulture-s/arkiv.git && cd arkiv
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pip install faster-whisper torch  # NVIDIA GPU
# pip install faster-whisper      # CPU fallback
ollama pull bge-m3 && ollama pull qwen2.5vl:7b && ollama pull qwen2.5:14b   # + minicpm-v (optional vision fallback)
python health.py

---

Windows (pip, PowerShell)

Install Python 3.9+, FFmpeg, and Ollama manually, then:

git clone https://github.com/vulture-s/arkiv.git; cd arkiv
python -m venv .venv; .\.venv\Scripts\activate
pip install -r requirements.txt
pip install faster-whisper torch  # NVIDIA GPU
# pip install faster-whisper      # CPU fallback
ollama pull bge-m3; ollama pull qwen2.5vl:7b; ollama pull qwen2.5:14b
$env:PYTHONUTF8=1; python health.py

UTF-8 required for CJK search. Always set $env:PYTHONUTF8=1 before starting the server.

---

Docker (all platforms)

git clone https://github.com/vulture-s/arkiv.git && cd arkiv
docker compose up -d
# Open http://localhost:8501

Models are pulled automatically on first run. For NVIDIA GPU passthrough on Linux, uncomment the deploy block in docker-compose.yml.

---

Verify

python health.py
# All required checks: PASS. SKIP = optional, does not affect functionality.

---

Tauri desktop app (optional)

npm install && cargo tauri dev   # requires Node.js + Rust toolchain

This site is open source. Improve this page.