Linux desktop AI · Version 0.5.0 · By Lorelei Noble · Updated October 10, 2026

Run local AI on Linux with Arynwood MCP

Arynwood MCP is an all-in-one local AI workspace for your Linux desktop. It combines a chat interface, model management, knowledge search and creative-tool connections. The desktop package contains the interface and backend; you install the models and supporting services separately.

This guide summarizes the v0.5.0 release and its installation documentation. It is a setup checklist. For measured CPU and GPU speeds, see Local AI without a GPU.

On Windows? v0.5.0 includes a Windows x64 alpha installer. It is unsigned, and the optional GPU tools and integrations have not been validated on Windows yet. Read the Windows setup and limitations before installing. The rest of this guide covers Linux.

Arynwood MCP chat window with persona tabs and a conversation
Want to look around before installing? The browser demo runs the real interface with scripted data.

What changed in 0.5.0?

The Community page now works with a Grove on a server, such as community.arynwood.com, whose compressed answers it couldn’t read in 0.4.9. A contrast check of every page found text below the 4.5:1 standard, including your own messages in Chat; all of it now passes. Python, frontend and Rust dependencies with published advisories are updated. Anyone on 0.4.8 or 0.4.9 sees an update notice for this release.

Included from earlier releases: Community inside the app (since 0.4.9), showing your Grove’s shared spaces from your computer or a server; automatic update checks at startup and every six hours while the app is open, with manual installation; checks send no credentials or workspace content to GitHub, which receives normal connection metadata including your IP address. CPU mode marks and disables NVIDIA-only tools while keeping CPU recording and editing available. Choose persistent chat and Design Center image endpoints on the Servers page. Hermes 3 now keeps system instructions when tools are attached, and MCP definitions and arguments are rechecked before dispatch. Read the updates and direct package downloads and the shipped security controls and remaining limits. Remote endpoints receive the prompts and data you send.

What hardware do you need?

Documented requirements for Arynwood MCP v0.5.0
ComponentRequirement
Operating systemLinux x86_64. AppImage or Debian/Ubuntu .deb. Windows x64 has a separate alpha installer (Windows notes). macOS is not supported.
Memory16 GB RAM in the project documentation; 8 GB can work with a smaller model or remote endpoint. Model size affects memory use.
StorageAt least 20 GB free, plus space for additional models and generated media.
Chat GPUOptional. Ollama can run chat on a CPU, with slower responses. Measured CPU speeds.
Creative GPU toolsNVIDIA GPU required for the documented GPU services; at least 12 GB VRAM is the project’s practical recommendation. Heavy services compete for VRAM.

Check the platform requirements before choosing which services to run.

Start with one local chat workflow

  1. Choose the package. Open the v0.5.0 release and download the x86_64 AppImage or .deb. Compare its SHA-256 checksum with the release’s SHA256SUMS.txt.
  2. Install and launch. Make the AppImage executable and run it, or install the .deb using your package manager. Follow the installation instructions, including the GStreamer packages needed for .deb audio and video.
  3. Choose local chat or an endpoint. For remote chat, add an Ollama or OpenAI-compatible server and select Use for chat on the Servers page. For local chat, install Ollama and download models; Ollama is not bundled. Use the quick start to configure the models used by the personas. Match model size to your available RAM and GPU memory.
  4. Verify chat first. Check that Ollama is reachable, select an installed model and send a message. Resolve model-loading or service errors before adding creative tools.
  5. Add knowledge search when needed. Install Qdrant and the Ollama embedding model specified in the knowledge-base instructions. These support retrieval from your documents and memory.

Linux Mint: install to first chat

Linux Mint 22.x uses the Ubuntu 24.04 package base. This path uses the existing Ollama install command and Arynwood MCP’s documented package and CPU-chat steps. Mint-specific app installation is untested; the laptop benchmark tested Ollama, not this desktop app. Check the runtime baseline first.

  1. Install Ollama and pull a small model. Run these commands in a terminal:
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2:1b

Install Arynwood MCP. Download the x86_64 .deb or AppImage and SHA256SUMS.txt from the release page. Compare the checksum before installing. In a terminal opened in the download folder, keep only the package you intend to install. Choose one route:

# .deb
sudo apt install ./arynwood-mcp_*.deb
# Documented media dependencies for the .deb
sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-pulseaudio

# Or AppImage
chmod +x arynwood-mcp_*.AppImage
./arynwood-mcp_*.AppImage

The AppImage bundles media plugins but needs the host ALSA runtime. The docs’ minimal-Ubuntu ALSA package command is untested on Mint’s newer package base; if dependencies are missing, use the platform and installation docs rather than guessing package substitutions.

Get the first reply. Launch the installed app, enter llama3.2:1b in the top bar, then open Agent Config, uncheck Use tools and click Save for plain chat. Send a message. While the model is loaded, run:

ollama ps

Success checks: ollama ps shows the selected model, and the first reply appears in Arynwood MCP. A completed download alone does not check chat. If the model is absent or the app reports an error, resolve it with the troubleshooting guide before adding other services.

Which features need extra setup?

What is missing from the packaged alpha?

The Community page needs a Grove, installed separately. IRC rooms and peer messages there belong to the Grove’s host, and peer messages are not yet verified end to end. LoRA training, script-based GPU tools such as Whisper and SadTalker, the project file browser and useful automatic project-tree context require a source checkout. The release download alone does not provide them.

The installation guide distinguishes script-based tools from separate HTTP services such as A1111. Consult the troubleshooting guide if a service is unavailable.

Is local AI private and offline?

Ollama inference runs on the machine hosting the model. For a local workflow, use local endpoints and installed models. Downloads, web search, remote endpoints and social publishing need network access. Review enabled integrations before using sensitive material; “local-first” describes a deployment choice, not a promise that every feature works offline.

Want help setting this up?

I offer paid local AI setup and workflow integration. Start with your hardware and one useful outcome, then scope the services needed to get there.

Explore local AI setup services

Running AI on your own Linux machine? Join the Linux Local AI Community on Facebook to compare setups and ask questions.