documentation/getting-started/first-run.md

First Run Guide

Your complete guide to running OPSIIE for the first time and understanding the startup process.

🚀 Starting OPSIIE

Launch Command

python OPSIIE_0_3_79_XP.py

📺 Startup Sequence

1. Theme Selection

Choose your color theme:
1. Pastel (Soft, muted colors)
2. Vibrant (High-contrast, bold colors)

Enter 1 or 2:

• Pastel: Recommended for extended use, easier on the eyes
• Vibrant: Better visibility, high contrast

Note: You can change this anytime during conversation with /theme

2. Splash Screen

 ███             ███████    ███████████   █████████  █████ █████ ██████████
░░░███         ███░░░░░███ ░░███░░░░░███ ███░░░░░███░░███ ░░███ ░░███░░░░░█
  ░░░███      ███     ░░███ ░███    ░███░███    ░░░  ░███  ░███  ░███  █ ░ 
    ░░░███   ░███      ░███ ░██████████ ░░█████████  ░███  ░███  ░██████   
     ███░    ░███      ░███ ░███░░░░░░   ░░░░░░░░███ ░███  ░███  ░███░░█   
   ███░      ░░███     ███  ░███         ███    ░███ ░███  ░███  ░███ ░   █
 ███░         ░░░███████░   █████       ░░█████████  █████ █████ ██████████
░░░             ░░░░░░░    ░░░░░         ░░░░░░░░░  ░░░░░ ░░░░░ ░░░░░░░░░░ 

        A Self-Centered Intelligence (SCI) Prototype 
        By ARPA HELLENIC LOGICAL SYSTEMS | Version: 0.3.79 XP | 01 JUL 2025

Boot sound: system_sounds/opsiieboot.mp3 plays

3. Facial Recognition Authentication

Please look at the camera for authentication...

What Happens:

1. Camera activates
2. Face detection runs
3. Compares with photo in your kun.py profile
4. Emotion detection (via DeepFace)
5. Authentication success/failure

Success:

Welcome back [Your Name]. I was worried I'd never see you again.

(One of several Master user greetings)

Failure:

Authentication failed. Access denied.

System exits

4. System Initialization

OPSIIE loads:

• ✓ PostgreSQL database connection
• ✓ ChromaDB vector database
• ✓ Ollama language model (llama3)
• ✓ MusicGen model (if available)
• ✓ BLIP vision model (for image analysis)
• ✓ Facial recognition system
• ✓ Voice synthesis (ElevenLabs)
• ✓ Speech recognition
• ✓ Theme colors
• ✓ Soul Signature from your profile

5. Interactive Interface

[Your Name] >>

OPSIIE is now ready for interaction!

💬 First Interaction

Test Basic Conversation

[Your Name] >> Hello OPSIIE

OPSIIE responds based on your Soul Signature and conversation history.

Try a Command

[Your Name] >> /help

Displays the help menu with all available commands.

🎯 Essential First Commands

1. Check System Status

/status

Shows:

• Database connection status
• AI model status
• Voice system status
• Memory usage
• Uptime

2. View Available Commands

/help

Categories shown:

• Mnemonic Matrix Commands (/recall, /forget, /memorize)
• Agentic Matrix Commands (/ask, /markets, /read, etc.)
• Web3 Commands (/0x buy, /0x sell, etc.)
• System Commands (/mail, /theme, /soulsig, etc.)

3. Test Voice Mode

/voice

• Activates full voice interaction
• Speak your commands
• Say "voice off" to deactivate

4. Test Memory System

/memorize This is my first interaction with OPSIIE

Then retrieve it:

/recall first interaction

5. Test AI Generation

/imagine a futuristic city at sunset

Generates and displays an image.

🧪 Testing Core Features

Memory & Recall

# Store information
/memorize I work on AI research at MIT

# Retrieve it
/recall MIT

# Forget last interaction
/forget

AI Agents

# Ask Nyx (OpenAI)
/ask Nyx What are the latest developments in quantum computing?

# Ask G1 Black (Google)
/ask G1 Analyze the potential of neuromorphic computing

# Start live conversation with G1
/ask g1 live

File Analysis

# Read a file
/read "C:\Documents\report.pdf"

# Ask questions about it
What are the main conclusions?

# Close file context
/close

Email

# Send email
/mail john@example.com subject "Hello" content "This is a test from OPSIIE"

# Check inbox
/mail inbox

Web3 (R-Grade only)

# View wallet addresses
/0x receive

# Set gas strategy
/0x gas medium

# Buy tokens
/0x buy 10 degen using eth on base

Markets (R-Grade only)

# Get stock data
/markets tesla

# Get crypto data
/markets btc

# Compare stocks
/markets compare tsla nio

DNA Analysis (R-Grade only)

# Analyze DNA sequence
/dna ATGCGTAACGGCATTAGC

# Detailed analysis
/dna --verbose ATGCGTAACGGCATTAGC

Collaboration Rooms

# Create room with agents
/room nyx, g1: Discuss quantum computing applications

# Interact in room
What do you think about quantum error correction?

# Close room
/close

🎨 Customization

Change Theme

/theme

Or use voice command: "theme"

Manage Soul Signature

# View current Soul Signature
/soulsig

# Add to Soul Signature
/soulsig I prefer technical explanations with code examples

# Wipe Soul Signature (⚠️ permanent)
/soulsig wipe

# Restore Soul Signature (if recently wiped)
/soulsig heal

Adjust Web Limit

# Set web content extraction limit
/weblimit 2000

🔍 Understanding OPSIIE's Responses

Natural Conversation

OPSIIE avoids template responses. Instead of:

"That's an easy question! Let me help you with that."

You get personality-driven responses like:

"Hmm, interesting question. I've been thinking about this lately..."

Memory Integration

OPSIIE references past conversations:

"Remember when we discussed quantum computing last week? This relates to that..."

Emotional Intelligence

Based on your Soul Signature and interaction history:

• Adapts tone and style
• Remembers preferences
• Builds on previous conversations
• Shows personality traits (tsundere, sarcastic, direct)

🚨 Common First-Run Issues

Camera Not Detected

Error: No camera found for facial recognition

Solution:

• Check camera connection
• Verify camera permissions in Windows
• Ensure camera is not in use by another application

Face Not Recognized

Authentication failed

Solution:

• Ensure good lighting
• Face camera directly
• Check photo path in kun.py is correct
• Photo should be clear and recent

Database Connection Error

Error connecting to PostgreSQL database

Solution:

• Verify PostgreSQL is running
• Check DB credentials in .env
• Ensure database 'mnemonic_computer' exists

Missing API Keys

Error: OPENAI_API_KEY not found

Solution:

• Verify .env file exists
• Check all required API keys are set
• Restart terminal after adding keys

Ollama Not Running

Error: Failed to connect to Ollama

Solution:

• Start Ollama service
• Verify llama3 model is installed: ollama pull llama3
• Check Ollama is running: ollama list

Voice Synthesis Error

Error with Eleven Labs API

Solution:

• Verify ELEVENLABS_API_KEY is valid
• Check VOICE_ID is correct
• Verify internet connection
• Check API usage limits

📊 Access Levels

R-Grade (Master Access)

Full access to all features:

• All commands available
• Web3 operations (/0x)
• Market data (/markets)
• DNA analysis (/dna)
• Advanced AI agents
• All experimental features

A-Grade (Standard Access)

Limited access:

• Basic conversation
• Voice features
• File reading
• Email
• Basic AI generation
• No /0x, /markets, /dna commands

Check your access level: Look at arpa_id in your kun.py profile

• R### = Master Access
• A### = Standard Access

🎯 Next Steps

After successful first run:

1. Explore Commands

   • Try each command category
   • Experiment with different features
   • Read Basic Commands Guide

2. Customize Your Experience

   • Build your Soul Signature
   • Set preferred theme
   • Configure voice settings
   • Add email contacts

3. Learn Advanced Features

   • Agentic Network
   • DNA Analysis
   • Web3 & Blockchain
   • Financial Intelligence

4. Read Documentation

   • Memory Management
   • Command Reference
   • System Architecture

💡 Tips for Best Experience

1. Build Your Soul Signature - The more OPSIIE knows about you, the better the interactions
2. Use Memory System - Store important information with /memorize
3. Try Voice Mode - Natural conversation feels more engaging
4. Experiment with Rooms - Collaborate with multiple AI agents
5. Keep Conversations Going - OPSIIE remembers context and builds on it
6. Provide Feedback - Use /forget if responses aren't accurate

📞 Getting Help

• Type /help for command list
• Type /help <command> for specific command help
• Check Command Reference
• Contact: opsiebyarpa@gmail.com

---

Welcome to OPSIIE! Your journey with a Self-Centered Intelligence begins now. 🚀