Installation

Choose the way you want to use Minara. The desktop app is the simplest route for most people. Browser, terminal, and Docker options are available when you want more control.

Desktop app

The desktop app bundles the Agent, Web UI, and automatic updates in one installer. You do not need Node.js, a build toolchain, or a terminal.

Platform	Supported package	Download
macOS (Apple Silicon)	`.dmg`	GitHub Releases
Windows (x64)	Installer	GitHub Releases
Linux (x64)	AppImage or `.deb`	GitHub Releases

Open the release page, download the package for your platform, install it, then sign in and start chatting. Release notes list the current build, signing status, and known issues.

Browser and command line

Use the installer when you want the Web UI in a browser or a terminal-first workflow.

curl -fsSL https://raw.githubusercontent.com/minara-ai/minara-agent/main/scripts/install.sh | bash

The installer supports Linux, macOS, WSL2, and Android through Termux. It checks for Node.js and the native build tools needed by the local database, installs Minara, and starts setup.

Windows: Use the desktop installer, or install WSL2 before running the command above. Native Windows shell installation is not supported.

What differs on native Windows

The desktop installer bundles the agent and runs it on native Windows, so the desktop app is the supported way to use Minara there. The shell installer above is the part that does not support native Windows.

Chat, research, market data, trading, automations, and the Web UI behave the same on every platform. These are the capabilities that do not:

Capability	Native Windows	macOS · Linux · WSL2
Terminal tool	Runs through `cmd.exe`	Runs through `/bin/sh`
Skill helper scripts	POSIX helpers (`.sh`, `jq`) do not run	Full
Coding project actions (install, build, test)	Unavailable — these require an OS filesystem jail	Available (bubblewrap on Linux, sandbox-exec on macOS)
Structured Git and Git over SSH	Unavailable	Available
Subprocess isolation	Command guard only	Command guard plus an OS filesystem jail

Run Minara under WSL2 if you need the rows marked unavailable.

After installation:

source ~/.zshrc             # or: source ~/.bashrc
minara setup                # connect Minara and an LLM provider
minara serve --ui           # open the Web UI at http://localhost:4173
minara                      # or start a terminal conversation

Minara needs a Minara account for market and trading services plus an LLM provider for reasoning. The setup wizard can guide you through both, or you can sign in directly:

minara auth login minara
minara auth login openai    # or anthropic, openrouter, xai, and other supported providers

See LLM Providers for provider choices and Environment Variables for key-based configuration.

Install from source

Use this route when you want to develop Minara or manage the checkout yourself.

git clone https://github.com/Minara-AI/minara-agent.git
cd minara-agent
corepack enable
pnpm install
pnpm dev

Node.js 24 or later and pnpm 9.15.0 are required. On macOS install Xcode Command Line Tools. On Debian or Ubuntu install build-essential so better-sqlite3 can build.

To update an installer-based checkout, run minara update. For a source checkout, pull the latest changes and run pnpm install again.

Docker

Docker starts the Web UI and gateway together:

pnpm docker

The first run creates .env from the example and stops so you can add credentials. Run the command again to build and start the stack. See Deployment for persistent data, upgrades, network exposure, and agent-only containers.

Check your setup

minara doctor
minara doctor --probe-llm

When the checks pass, you are ready to use Minara. Start with Your First Trade or explore the Web UI.