Installation

How to install and run RA-OS on your machine

Installation

RA-OS runs as a Next.js application with a local SQLite database. You can run it locally for development or deploy it to a server.

Prerequisites

  • Node.js 18+ — Download
  • Git — Download
  • API Keys — At least one AI provider (OpenAI, Anthropic, or OpenRouter)

Local Development

1. Clone the Repository

git clone https://github.com/bradwmorris/ra-h_os.git
cd ra-h_os

2. Install Dependencies

npm install

3. Configure Environment

Copy the example environment file and add your API keys:

cp .env.example .env.local

Edit .env.local with your API keys (see Configuration for details).

4. Start the Development Server

npm run dev

Open http://localhost:3000 in your browser.

Database Location

By default, RA-OS stores its SQLite database at:

~/Library/Application Support/RA-H/rah.sqlite

You can change this by setting the DATABASE_PATH environment variable.

Updating

To update to the latest version:

git pull origin main
npm install
npm run dev

Troubleshooting

Port Already in Use

If port 3000 is already in use, you can specify a different port:

npm run dev -- -p 3001

Database Issues

If you encounter database errors, you can reset by deleting the SQLite file:

rm ~/Library/Application\ Support/RA-H/rah.sqlite

A fresh database will be created on next startup.

Missing Dependencies

If you see module not found errors, try:

rm -rf node_modules package-lock.json
npm install

Next Steps