File size: 9,924 Bytes

768f568

# 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

```env

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

```env

# 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

```env

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

```env

SENDER_EMAIL=your_email@gmail.com

SENDER_PASSWORD=your_app_password  # Gmail app-specific password

```



### Scientific APIs

```env

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
```python

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**
```python

"Prefers direct communication without pleasantries"

"Values detailed technical explanations"

"Likes sarcastic humor and wit"

"Avoids template-like responses"

```

**Interests & Expertise**
```python

"Deep interest in blockchain technology"

"Background in molecular biology"

"Enjoys philosophical discussions"

"Works in quantum computing field"

```

**Interface Preferences**
```python

"Prefers dark mode interfaces"

"Likes minimalist design"

"Values visual data representations"

```

**Interaction Patterns**
```python

"Remembers past conversations and builds on them"

"Appreciates when OPSIIE shows initiative"

"Enjoys creative and artistic pursuits"

```

**Personal Instructions**
```python

"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**
```bash

/theme                    # Opens theme selector

# Or voice command: "theme"

```

### Custom Theme Colors (terminal_colors.py)



```python

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

```bash

/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`:

```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:

```env

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

```python

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
```python

TOKENS = {

    'Degen': {

        'Base': '0x4ed4e862860bed51a9570b96d89af5e1b0efefed'

    },

    'USDC': {

        'Base': '0x7F5c764cBc14f9669B88837ca1490cCa17c31607',

        'Ethereum': '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606EB48',

        'Polygon': '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'

    }

}

```

### Gas Strategy
```bash

/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`:
```env

SENDER_EMAIL=your_email@gmail.com

SENDER_PASSWORD=your_app_password

```

### Known Contacts
Contacts are automatically mapped from kun.py user profiles:
```python

# Any user with 'mail' field becomes a known contact

'mail': 'contact@example.com'

```

## 📁 File Processing Limits

### Web Content Limit
```bash

/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:
```bash

/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:
```bash

/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](first-run.md)
2. Test basic commands
3. Customize Soul Signature
4. Explore [Basic Commands](../user-guides/basic-commands.md)