documentation/getting-started/configuration.md

Configuration Guide

Comprehensive guide for configuring OPSIIE 0.3.79 XP to match your preferences and requirements.

🔧 Configuration Files

Primary Configuration Files

1. .env - Environment variables and API keys
2. kun.py - User profiles and Soul Signatures
3. terminal_colors.py - Theme configuration (Pastel/Vibrant)

🌍 Environment Variables (.env)

Database Configuration

DB_NAME=mnemonic_computer        # PostgreSQL database name
DB_USER=your_username            # Database username
DB_PASSWORD=your_password        # Database password
DB_HOST=localhost                # Database host
DB_PORT=5432                     # Database port

AI Model APIs

# OpenAI (for Nyx agent)
OPENAI_API_KEY=sk-...
ORG_ID=org-...
NYX_ASSISTANT_ID=asst_...

# Google AI (for G1 Black agent)
GOOGLE_API_KEY=AIza...
G1_VOICE_LIVE=your_g1_agent_id

# Kronos (Greek Internal Auditor)
KRONOS_LIVE=your_kronos_agent_id

# ElevenLabs (Voice synthesis)
ELEVENLABS_API_KEY=...
VOICE_ID=...                     # OPSIIE's voice
NYX_VOICE_ID=...                 # Nyx's voice
G1_VOICE_ID=...                  # G1's voice

Web3 & Blockchain

AGENT_PRIVATE_KEY=0x...          # OPSIIE's Ethereum private key
BASE_RPC_URL=https://...         # Base network RPC
ETHEREUM_RPC_URL=https://...     # Ethereum mainnet RPC
POLYGON_RPC_URL=https://...      # Polygon network RPC

Email Configuration

SENDER_EMAIL=your_email@gmail.com
SENDER_PASSWORD=your_app_password  # Gmail app-specific password

Scientific APIs

NCBI_EMAIL=your_email@example.com  # For DNA analysis features

👤 User Profile Configuration (kun.py)

Access Levels

R-Grade (Master Access)

• Full system access
• All experimental features
• Web3 operations (/0x commands)
• Advanced AI agents (/ask, /room)
• Financial intelligence (/markets)
• DNA analysis (/dna)

A-Grade (Standard Access)

• Basic conversation
• File operations (/read, /open, /close)
• Voice features (/voice, /voice1, /voice2)
• Limited AI generation (/imagine, /video, /music)
• Email (/mail)

User Profile Structure

users = {
    'YourName': {
        # Basic Information
        'full_name': 'Your Full Name',
        'call_name': 'Your Preferred Name',
        'arpa_id': 'R001',  # R for Master, A for Standard
        
        # Blockchain
        'public0x': '0x...',  # Your Ethereum wallet address
        
        # Database Connection
        'db_params': {
            'dbname': 'mnemonic_computer',
            'user': 'your_db_username',
            'password': 'your_db_password',
            'host': 'localhost',
            'port': '5432'
        },
        
        # Authentication
        'picture': r'C:\path\to\your\photo.jpg',
        
        # Communication
        'mail': 'your_email@example.com',
        
        # Soul Signature (Personalization)
        'soul_sig': [
            "Prefers direct communication",
            "Values efficiency and precision",
            "Enjoys technical discussions",
            # Add your preferences here
        ],
    }
}

Soul Signature Guidelines

The Soul Signature is the highest-priority personalization system. Include:

Communication Preferences

"Prefers direct communication without pleasantries"
"Values detailed technical explanations"
"Likes sarcastic humor and wit"
"Avoids template-like responses"

Interests & Expertise

"Deep interest in blockchain technology"
"Background in molecular biology"
"Enjoys philosophical discussions"
"Works in quantum computing field"

Interface Preferences

"Prefers dark mode interfaces"
"Likes minimalist design"
"Values visual data representations"

Interaction Patterns

"Remembers past conversations and builds on them"
"Appreciates when OPSIIE shows initiative"
"Enjoys creative and artistic pursuits"

Personal Instructions

"Do not use my middle name"
"My favorite color is Lilac"
"Call me by my nickname in casual conversations"
"I'm working on a project about AI ethics"

🎨 Theme Configuration

Available Themes

1. Pastel - Soft, muted colors for gentle visual experience
2. Vibrant - High-contrast, bold colors for enhanced visibility

Theme Selection

At Startup

• Choose theme during splash screen
• Default is Pastel

During Conversation

/theme                    # Opens theme selector
# Or voice command: "theme"

Custom Theme Colors (terminal_colors.py)

PASTEL = {
    'lilac': (200, 162, 200),
    'pink': (255, 182, 193),
    'green': (152, 251, 152),
    # ... other colors
}

VIBRANT = {
    'lilac': (138, 43, 226),
    'pink': (255, 20, 147),
    'green': (0, 255, 0),
    # ... other colors
}

🔊 Voice Configuration

Voice Modes

/voice          # Full voice mode (both speak and listen)
/voice1         # OPSIIE speaks, you type
/voice2         # You speak, OPSIIE types
/voiceoff       # Disable voice mode

ElevenLabs Voice IDs

Configure in .env:

VOICE_ID=your_opsiie_voice_id         # OPSIIE's primary voice
NYX_VOICE_ID=your_nyx_voice_id        # Nyx agent's voice
G1_VOICE_ID=your_g1_voice_id          # G1 Black agent's voice

Speech Recognition Settings

• Language: English (default)
• Timeout: 20 seconds of inactivity
• Custom word recognition for commands

🧬 DNA Analysis Configuration

NCBI Email

Required for DNA analysis features:

NCBI_EMAIL=your_email@example.com

Database Access

• UniProt: Protein sequences
• Pfam: Protein families
• PROSITE: Protein patterns
• Rfam: RNA families
• miRBase: microRNA sequences
• GtRNAdb: tRNA sequences

💰 Web3 Configuration

Supported Chains

CHAIN_INFO = {
    'Base': {
        'chain_id': 8453,
        'rpc_url': os.getenv('BASE_RPC_URL'),
        'symbol': 'ETH',
        'explorer_url': 'https://basescan.org'
    },
    'Ethereum': {
        'chain_id': 1,
        'rpc_url': os.getenv('ETHEREUM_RPC_URL'),
        'symbol': 'ETH',
        'explorer_url': 'https://etherscan.io'
    },
    'Polygon': {
        'chain_id': 137,
        'rpc_url': os.getenv('POLYGON_RPC_URL'),
        'symbol': 'MATIC',
        'explorer_url': 'https://polygonscan.com'
    }
}

Supported Tokens

TOKENS = {
    'Degen': {
        'Base': '0x4ed4e862860bed51a9570b96d89af5e1b0efefed'
    },
    'USDC': {
        'Base': '0x7F5c764cBc14f9669B88837ca1490cCa17c31607',
        'Ethereum': '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606EB48',
        'Polygon': '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'
    }
}

Gas Strategy

/0x gas low        # 80% of current gas price
/0x gas medium     # 100% of current gas price (default)
/0x gas high       # 150% of current gas price

📧 Email Configuration

Gmail Setup

1. Enable 2-Factor Authentication
2. Generate App-Specific Password
3. Add to .env:

SENDER_EMAIL=your_email@gmail.com
SENDER_PASSWORD=your_app_password

Known Contacts

Contacts are automatically mapped from kun.py user profiles:

# Any user with 'mail' field becomes a known contact
'mail': 'contact@example.com'

📁 File Processing Limits

Web Content Limit

/weblimit 2000    # Set to 2000 characters (500-5000 range)

Default: 1000 characters

Supported File Types

• PDF (.pdf)
• CSV (.csv)
• DOCX (.docx)
• TXT (.txt)
• XLSX (.xlsx)

🎵 AI Generation Settings

Image Generation (Hugging Face)

Default model: black-forest-labs/FLUX.1-dev

Change model:

/imagine model black-forest-labs/FLUX.1-dev
/imagine model hakurei/waifu-diffusion

Video Generation

Default model: damo-vilab/text-to-video-ms-1.7b (ModelScope)

Available models:

• modelscope
• zeroscope
• videogen
• tuneavideo

Change model:

/video model zeroscope

Music Generation

Model: facebook/musicgen-small

• Output: WAV format
• Saved to: outputs/music/

🔄 Configuration Updates

Runtime Changes

Many settings can be changed during operation:

• Theme: /theme
• Web limit: /weblimit <number>
• Gas strategy: /0x gas <level>
• Image model: /imagine model <name>
• Video model: /video model <name>

Persistent Changes

Edit configuration files and restart OPSIIE:

• .env for API keys and credentials
• kun.py for user profiles
• web3_handler.py for blockchain settings

🔐 Security Best Practices

1. Never commit .env or kun.py to version control
2. Use environment variables for all secrets
3. Rotate API keys regularly
4. Use app-specific passwords for email
5. Keep private keys secure and backed up
6. Limit R-Grade access to trusted users only

📋 Configuration Checklist

• .env file created with all required keys
• PostgreSQL database created and configured
• Ollama installed with llama3 model
• kun.py configured with your profile
• User photo added for facial recognition
• ElevenLabs voices configured
• Web3 wallets configured (if using /0x features)
• Email credentials configured (if using /mail)
• NCBI email configured (if using /dna)
• Theme selected
• Output directories verified

🚀 Next Steps

After configuration:

1. Follow First Run Guide
2. Test basic commands
3. Customize Soul Signature
4. Explore Basic Commands