Installation

Clarissa can be installed in several ways depending on your preferences and setup. All methods require Bun v1.0 or later and an OpenRouter API key.

Requirements

From npm (Recommended)

The easiest way to install Clarissa is via npm or bun:

Using Bun

bun install -g clarissa

Using npm

npm install -g clarissa

From Source

Clone the repository and link the package locally:

git clone https://github.com/cameronrye/clarissa.git
cd clarissa
bun install
bun link

This will make the clarissa command available globally on your system.

Standalone Binary

Download a pre-built binary from the releases page and add it to your PATH.

Available Platforms

Platform Binary Name
macOS (ARM) clarissa-macos-arm64
macOS (Intel) clarissa-macos-x64
Linux (x64) clarissa-linux-x64
Linux (ARM) clarissa-linux-arm64
Windows (x64) clarissa-windows-x64.exe

Example: macOS ARM

chmod +x clarissa-macos-arm64
mv clarissa-macos-arm64 /usr/local/bin/clarissa

Verify Installation

After installation, verify that Clarissa is working:

clarissa --help

Quick Setup

Run the setup command to configure your API key:

clarissa init

This will prompt for your OpenRouter API key and create the config file automatically.

Next Steps

For more configuration options, see the configuration guide. Or jump straight to using Clarissa.