Getting Started with RiftNet AI

Learn how to install, configure, and run the RiftNet AI system—even if you've never touched Node.js before.

Table of Contents

Getting Started with RiftNet AI

Updated: June 11, 2025
RiftNet Team
AI Node.js Second Life Setup Guide MongoDB

Getting Started with RiftNet AI

RiftNet AI is a smart assistant designed to interact with Second Life using OpenAI. This no-bullshit guide is built for people who’ve never touched a Node app before.

What You’ll Need

  • Node.js installed
  • MongoDB installed and running
  • Your OpenAI API key
  • Your Second Life bot credentials
  • The RiftNet AI app from RiftNet.net

Step 1: Install Node.js and MongoDB

Node.js

  1. Download from https://nodejs.org
  2. Install it with all default options
  3. Open Command Prompt or Terminal and type:
node -v

It should show a version number.

MongoDB

  1. Download Community Server from https://www.mongodb.com/try/download/community
  2. Install it. Use default settings.
  3. Start MongoDB by running:
mongod

Leave this window open. Mongo has to run in the background.

Step 2: Download RiftNet AI

  1. Grab the latest zip from https://RiftNet.net
  2. Extract it somewhere easy, like C:\RiftNetAI or ~/RiftNetAI

Step 3: Configure the Bot

  1. Inside the RiftNet folder, open config.yml
  2. Fill in these lines:
username: YourSecondLifeBotFirstName
password: YourSecondLifeBotPassword
apikey: sk-your_openai_api_key

Step 4: Install Node Dependencies

  1. Open terminal or command prompt
  2. Navigate to the app folder:
cd path/to/RiftNetAI
  1. Install everything:
npm install

Step 5: Run MongoDB

Make sure MongoDB is running:

  • If you closed the mongod window, reopen a terminal and run:
mongod

That’s the database RiftNet uses. Leave it running.

Step 6: Start RiftNet AI

  1. Open another terminal
  2. Navigate to the app folder again:
cd path/to/RiftNetAI
  1. Run it:
node app.js
  1. You’ll see logs confirming it's running. If it connects to Second Life, you're in.

Troubleshooting

MongoDB not found

  • Make sure it's installed and running with mongod
  • If you get errors, reboot and try again

OpenAI key issues

  • Double check the format: sk-XXXXXXXXXXXXXXXXXXXXXX
  • Don't include quotes or spaces

Login fails

  • Your Second Life bot must be a valid account
  • If SL changed login rules, recheck your password or region bans

What’s Next?

  • Add your own responses or prompts
  • Connect other OpenAI models
  • Explore the source and start customizing

Support