Installation¶

Requirements¶

• Python 3.10+ (tested on 3.11/3.12/3.13)
• uv (recommended) or pip

Install with uv (recommended)¶

git clone https://github.com/shushuzn/Rairos.git
cd Rairos
uv sync --all-extras
rairos --help

Install with pip¶

pip install -e ".[all]"

Both install the rairos CLI entry point.

Initialize Database¶

rairos init

Creates the SQLite database at ~/.ai_research_os/papers.db.

Ollama (Optional — for Semantic Dedup)¶

For dedup-semantic command, install Ollama and pull the embedding model:

ollama pull nomic-embed-text

The CLI will automatically use http://localhost:11434 for embeddings.

Verify¶

rairos --help
rairos status   # shows database stats

Uninstall¶

pip uninstall ai-research-os
rm -rf ~/.ai_research_os   # remove database and cache