Installing Rosett-AI

From .deb Package (Recommended)

Download the latest .deb package from the releases page.

# Install the package
sudo dpkg -i nncc_1.0.0-1_amd64.deb

# Install any missing dependencies
sudo apt-get install -f

# Verify installation
raictl version

APT Repository

The APT repository provides signed packages with automated updates.

# Download and install the repository GPG key
curl -fsSL https://repo.neatnerds.be/gpg.key \
  | sudo gpg --dearmor -o /etc/apt/keyrings/neatnerds.gpg

# Add the stable repository
echo "deb [signed-by=/etc/apt/keyrings/neatnerds.gpg arch=amd64] https://repo.neatnerds.be/stable bookworm main" \
  | sudo tee /etc/apt/sources.list.d/neatnerds.list

# Install rosett-ai
sudo apt-get update
sudo apt-get install rosett-ai

For ARM64 systems, replace arch=amd64 with arch=arm64.

For the unstable channel (latest development builds from main):

echo "deb [signed-by=/etc/apt/keyrings/neatnerds.gpg arch=amd64] https://repo.neatnerds.be/unstable bookworm main" \
  | sudo tee /etc/apt/sources.list.d/neatnerds-unstable.list

Verifying Package Signatures

All packages are GPG-signed. To verify a downloaded .deb:

dpkg-sig --verify nncc_*.deb

Post-Install Verification

After installation, verify that rosett-ai is working correctly:

# Check version
raictl version

# Initialize global configuration
rai init --global

# Validate configuration files
rai validate

# View man page
man raictl

Package Contents

The .deb package installs:

Path	Description
/opt/rosett-ai/	Application directory (embedded Ruby + app)
/opt/rosett-ai/bin/raictl	Wrapper script
/usr/local/bin/raictl	Symlink (created by postinst)
/etc/rosett-ai/settings.json	Default configuration (conffile)
/usr/share/man/man1/rai.1.gz	Man page

Uninstalling

# Remove the package (keeps configuration)
sudo apt-get remove rosett-ai

# Remove the package and its configuration
sudo apt-get purge rosett-ai

Troubleshooting

"command not found" after install

The postinst script creates a symlink at /usr/local/bin/raictl. If it is missing, recreate it manually:

sudo ln -sf /opt/rosett-ai/bin/raictl /usr/local/bin/raictl

"Engine not found" when compiling

Install the engine plugin gem for your target tool:

gem install rosett-ai-engine-claude    # Claude Code
gem install rosett-ai-engine-cursor    # Cursor
gem install rosett-ai-engine-agents_md # AGENTS.md

Run rai engines list to see all available engines and rai engines detect to check which are installed.

Dependency errors during install

sudo apt-get install -f

This resolves any missing system library dependencies (libffi, libyaml, libssl, etc.) required by the embedded Ruby runtime.

"Permission denied" errors

The .deb package installs to /opt/rosett-ai/ which is owned by root. User data lives in ~/.claude/ and ~/.config/rosett-ai/ which must be owned by your user:

ls -la ~/.claude/
ls -la ~/.config/rosett-ai/

If permissions are wrong, fix them:

sudo chown -R "$USER:$USER" ~/.claude/ ~/.config/rosett-ai/

Building from Source

See SETUP.md for development setup instructions.

# Build the .deb package
bin/raictl build package --verbose

# Output will be in pkg/
ls pkg/*.deb