Upload 33 files

.gitattributes

@@ -34,3 +34,7 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 greeting.mp3 filter=lfs diff=lfs merge=lfs -text
+system_sounds/alert.mp3 filter=lfs diff=lfs merge=lfs -text
+system_sounds/drill.mp3 filter=lfs diff=lfs merge=lfs -text
+system_sounds/heal.mp3 filter=lfs diff=lfs merge=lfs -text
+system_sounds/opsiieboot.mp3 filter=lfs diff=lfs merge=lfs -text

documentation/README.md

@@ -0,0 +1,99 @@
+# OPSIIE 0.3.79 XP Documentation
+
+**Self-Centered Intelligence - AI with Memory and Personality**
+
+OPSIIE is an advanced AI system with long-term memory, voice interaction, and multi-modal capabilities.
+
+## 🚀 What is OPSIIE?
+
+- 🧠 **Memory** - Mnemonic Matrix stores conversations
+- 🎤 **Voice** - Full voice interaction
+- 🎨 **Generation** - Images, videos, music
+- 📧 **Email** - Gmail integration
+- 📁 **Documents** - PDF, CSV, DOCX analysis
+- 🤖 **Agents** - Nyx, G1, Kronos (R-Grade)
+- 🧬 **DNA** - Bioinformatics (R-Grade)
+- 📊 **Markets** - Financial data (R-Grade)
+- 🔗 **Web3** - Blockchain operations (R-Grade)
+
+## 📚 Documentation
+
+### 🎯 [Getting Started](getting-started/installation.md)
+- [Installation](getting-started/installation.md)
+- [Configuration](getting-started/configuration.md)
+- [First Run](getting-started/first-run.md)
+
+### 📖 [User Guides](user-guides/README.md)
+- [Quick Start](user-guides/quick-start.md)
+- [First Time User](user-guides/first-time-user.md)
+- [Basic Commands](user-guides/basic-commands.md)
+- [Memory Management](user-guides/memory-management.md)
+
+### ⚡ [Core Features](core-features/README.md)
+- [Memory System](core-features/memory.md)
+- [Voice Interaction](core-features/voice.md)
+- [AI Generation](core-features/ai-generation.md)
+- [Communication](core-features/communication.md)
+- [Document Intelligence](core-features/document-intelligence.md)
+
+### 🚀 [Advanced Features](advanced-features/README.md)
+R-Grade required:
+- [Agentic Network](advanced-features/agentic-network.md)
+- [DNA Analysis](advanced-features/dna-analysis.md)
+- [Financial Intelligence](advanced-features/financial-intelligence.md)
+- [Web3 & Blockchain](advanced-features/web3-blockchain.md)
+
+### 📋 [API Reference](api-reference/README.md)
+- [Command Reference](api-reference/command-reference.md)
+- [Error Codes](api-reference/error-codes.md)
+
+### 🏗️ [System Architecture](system-architecture/README.md)
+- [Core Components](system-architecture/core-components.md)
+- [Security Model](system-architecture/security-model.md)
+- [Technology Stack](system-architecture/technology-stack.md)
+
+## 🔑 Access Levels
+
+**R-Grade (Master)**: ARPA ID R### - Full access
+**A-Grade (Standard)**: ARPA ID A### - Core features only
+
+## 🚀 Essential Commands
+
+**All Users**:
+```bash
+/recall, /memorize, /forget, /soulsig
+/voice, /voice1, /voice2
+/imagine, /video, /music
+/mail, /read
+/status, /theme, /help
+```
+
+**R-Grade Only**:
+```bash
+/ask, /ask live, /room
+/markets, /markets compare
+/dna
+/0x buy, /0x sell, /0x send
+```
+
+## 🏁 Quick Start
+
+```bash
+# Install
+pip install -r requirements.txt
+
+# Configure .env and kun.py
+
+# Run
+python OPSIIE_0_3_79_XP.py
+```
+
+## 📞 Support
+
+Email: opsiebyarpa@gmail.com
+
+---
+
+**Intelligence meets personality.** ✨
+
+*ARPA Corporation*

documentation/advanced-features/README.md

@@ -0,0 +1,79 @@
+# Advanced Features
+
+Specialized capabilities for R-Grade users including AI agents, DNA analysis, financial intelligence, and Web3.
+
+## 🚀 Feature Overview
+
+### [Agentic Network](agentic-network.md) 🤖
+Multi-agent collaboration with Nyx, G1 Black, and Kronos.
+- `/ask <agent>` - Query AI agents
+- `/ask g1 live` - Real-time voice
+- `/room` - Collaboration spaces
+
+### [DNA Analysis](dna-analysis.md) 🧬
+GDDA bioinformatics system.
+- `/dna <sequence>` - Analyze DNA/RNA/Protein
+- Structure prediction
+- Homology search
+- Database cross-refs
+
+### [Financial Intelligence](financial-intelligence.md) 📊
+Real-time market data via Yahoo Finance.
+- `/markets <stock>` - Stock data
+- `/markets <crypto>` - Crypto prices
+- `/markets compare` - Stock comparison
+
+### [Web3 & Blockchain](web3-blockchain.md) 🔗
+Multi-chain operations on Base, Ethereum, Polygon.
+- `/0x buy/sell` - Token trading
+- `/0x send` - Transfers
+- `/0x receive` - View wallets
+
+## ⚠️ Access Requirements
+
+**All advanced features require R-Grade (Master) access.**
+
+R-Grade users have `arpa_id` starting with 'R' in kun.py:
+```python
+'arpa_id': 'R001'  # R-Grade Master access
+```
+
+A-Grade users (`arpa_id` starting with 'A') cannot access these features.
+
+## 🚀 Quick Examples
+
+**Agentic Network:**
+```bash
+/ask Nyx Design a blockchain voting system
+/ask g1 live
+/room nyx, g1: Quantum computing
+```
+
+**DNA Analysis:**
+```bash
+/dna ATGCGTAACGGCATTAGC
+/dna --verbose --homology MAKVLISPKQW
+```
+
+**Financial:**
+```bash
+/markets tesla
+/markets btc
+/markets compare tsla nio
+```
+
+**Web3:**
+```bash
+/0x buy 10 degen using eth on base
+/0x send base eth 0.1 to Ross
+/0x receive
+```
+
+## 📖 Learn More
+
+- [Command Reference](../api-reference/command-reference.md)
+- [System Architecture](../system-architecture/core-components.md)
+
+---
+
+**Advanced features for power users.** ⚡

documentation/advanced-features/agentic-network.md

@@ -0,0 +1,44 @@
+# Agentic Network & Rooms
+
+Multi-agent collaboration system with Nyx, G1 Black, and Kronos agents.
+
+## 🤖 Agents
+
+**OPSIIE**: Main coordinator, all features
+**Nyx (OpenAI)**: Blockchain, AI, Python prototyping
+**G1 Black (Gemini)**: Quantum, technical analysis, live voice
+**Kronos**: Greek auditing, compliance, live voice
+
+## 📝 Commands
+
+### /ask Agent
+```bash
+/ask Nyx <prompt>
+/ask G1 <prompt>
+/ask Kronos <prompt>
+```
+
+### Live Voice
+```bash
+/ask g1 live      # Real-time voice with G1
+/ask kronos live  # Real-time voice with Kronos
+```
+
+### Rooms
+```bash
+/room <agents>: <theme>
+/room nyx, g1: Quantum computing
+/close  # Close and save room
+```
+
+## 🔧 Setup
+
+Requires R-Grade access and API keys in .env:
+- OPENAI_API_KEY
+- GOOGLE_API_KEY  
+- G1_VOICE_LIVE
+- KRONOS_LIVE
+
+---
+
+**Collaborative intelligence.**

documentation/advanced-features/dna-analysis.md

@@ -0,0 +1,43 @@
+# DNA Analysis - GDDA System
+
+Genetic Due Diligence Analysis (GDDA) v0.21 XP for bioinformatics.
+
+## 🧬 Command
+
+### /dna - Analyze Sequence
+```bash
+/dna <sequence> [options]
+```
+
+**Examples:**
+```bash
+/dna ATGCGTAACGGCATTAGC        # DNA
+/dna AUGCGUAACGGCAUUAGC        # RNA
+/dna MAKVLISPKQW               # Protein
+/dna --verbose ATGCGTAACGGC    # Detailed
+/dna --homology MAKVLISPKQW    # With search
+```
+
+## 🔬 Features
+
+**Basic**: Type detection, GC content, k-mer frequency
+**Structure**: DNA melting temp, RNA secondary, protein prediction
+**Advanced**: Homology search, patents, literature
+**RNA**: miRNA sites, siRNA regions, Rfam/miRBase refs
+**Protein**: Weight, localization, UniProt/Pfam refs
+
+## ⚙️ Options
+
+`--verbose` `--type` `--format` `--export` `--homology` `--structure` `--patents` `--literature`
+
+## 🔧 Setup
+
+```env
+NCBI_EMAIL=your_email@example.com
+```
+
+**R-Grade Required**
+
+---
+
+**Bioinformatics intelligence.** 🧬

documentation/advanced-features/financial-intelligence.md

@@ -0,0 +1,213 @@
+# Financial Intelligence - Markets
+
+Real-time financial data analysis for stocks, crypto, and currencies via Yahoo Finance.
+
+## 📊 Overview
+
+Market analysis features:
+- Stock data and news
+- Cryptocurrency prices
+- Currency exchange rates
+- Company financials
+- Stock comparison
+- Technical analysis
+
+## 📝 Commands
+
+### /markets - Get Market Data
+```bash
+/markets <keyword> [extra]
+```
+
+**Examples:**
+```bash
+# Stocks
+/markets tesla
+/markets shell
+/markets nio
+
+# Crypto
+/markets btc
+/markets eth
+/markets doge
+
+# Currencies
+/markets usd
+/markets eur
+
+# Detailed analysis
+/markets tesla statistics
+/markets shell financials
+/markets nio analysis
+
+# Compare stocks
+/markets compare tsla nio
+/markets compare aapl msft
+```
+
+## 📈 Data Types
+
+### Basic Stock Data
+```bash
+/markets <company>
+```
+
+Shows:
+- Current price
+- Performance metrics
+- Price chart (ASCII)
+- Top news articles
+
+### Cryptocurrency
+```bash
+/markets <crypto>
+```
+
+Shows:
+- Latest price
+- Performance (1d, 7d, 30d)
+- Market cap
+- Circulating supply
+- Volume
+- ASCII chart
+
+### Currency Exchange
+```bash
+/markets <currency>
+```
+
+Shows:
+- Current exchange rate
+- Performance data
+- Volume and range
+- ASCII chart
+
+### Detailed Analysis
+
+**statistics:**
+```bash
+/markets <company> statistics
+```
+Key stats, valuation, financial highlights
+
+**history:**
+```bash
+/markets <company> history
+```
+Historical price data
+
+**profile:**
+```bash
+/markets <company> profile
+```
+Industry, sector, employees, business summary
+
+**financials:**
+```bash
+/markets <company> financials
+```
+Financial statements
+
+**analysis:**
+```bash
+/markets <company> analysis
+```
+Analyst recommendations and estimates
+
+**options:**
+```bash
+/markets <company> options
+```
+Options chain and expiration dates
+
+**holders:**
+```bash
+/markets <company> holders
+```
+Major and institutional shareholders
+
+**sustainability:**
+```bash
+/markets <company> sustainability
+```
+ESG scores and metrics
+
+### Stock Comparison
+```bash
+/markets compare <stock1> <stock2>
+```
+
+Compares:
+- Market capitalization
+- Revenue growth
+- Profit margins
+- Financial ratios
+- P/E ratio
+- Debt-to-equity
+- ROE, ROA
+- Dividend yield
+
+## 🔧 Configuration
+
+Uses Yahoo Finance API:
+- Real-time data
+- No API key required
+- Internet connection needed
+
+## 💡 Best Practices
+
+**Stock Tickers:**
+```bash
+✅ /markets tsla      # Tesla
+✅ /markets aapl      # Apple  
+✅ /markets msft      # Microsoft
+```
+
+**Crypto Symbols:**
+```bash
+✅ /markets btc       # Bitcoin
+✅ /markets eth       # Ethereum
+✅ /markets ada       # Cardano
+```
+
+**Currency Codes:**
+```bash
+✅ /markets usd       # US Dollar
+✅ /markets eur       # Euro
+✅ /markets jpy       # Japanese Yen
+```
+
+## 🚨 Troubleshooting
+
+**Symbol not found:** Check ticker symbol spelling
+**No data:** Verify internet connection
+**Timeout:** Retry or try simpler query
+
+## 🎯 Use Cases
+
+**Investment Research:**
+```bash
+/markets tesla statistics
+/markets compare tsla nio
+```
+
+**Crypto Monitoring:**
+```bash
+/markets btc
+/markets eth
+```
+
+**Market Overview:**
+```bash
+/markets aapl
+/markets googl
+/markets msft
+```
+
+## 📊 Access Control
+
+**R-Grade Required** for markets features
+
+---
+
+**Financial intelligence in real-time.** 📊

documentation/advanced-features/web3-blockchain.md

@@ -0,0 +1,196 @@
+# Web3 & Blockchain
+
+Multi-chain Web3 operations on Base, Ethereum, and Polygon networks.
+
+## 🔗 Overview
+
+Web3 capabilities:
+- Token trading (buy/sell)
+- Token transfers
+- Multi-chain support
+- Gas strategy control
+- Custom token/chain addition
+- DEX integration
+
+## 🌐 Supported Chains
+
+**Base** (Chain ID: 8453)
+- Native: ETH
+- Explorer: basescan.org
+
+**Ethereum** (Chain ID: 1)
+- Native: ETH
+- Explorer: etherscan.io
+
+**Polygon** (Chain ID: 137)
+- Native: MATIC
+- Explorer: polygonscan.com
+
+## 💰 Supported Tokens
+
+**Degen**: Base network
+**USDC**: Base, Ethereum, Polygon
+
+## 📝 Commands
+
+### Buy Tokens
+```bash
+/0x buy <amount> <token> using <token> on <chain>
+```
+
+**Examples:**
+```bash
+/0x buy 10 degen using eth on base
+/0x buy 100 usdc using eth on ethereum
+/0x buy 50 degen using usdc on base
+```
+
+### Sell Tokens
+```bash
+/0x sell <amount> <token> for <token> on <chain>
+```
+
+**Examples:**
+```bash
+/0x sell 5 degen for eth on base
+/0x sell 100 usdc for eth on polygon
+/0x sell 10 degen for usdc on base
+```
+
+### Send Tokens
+```bash
+/0x send <chain> <token> <amount> to <recipient>
+```
+
+**Examples:**
+```bash
+/0x send base eth 0.1 to Ross
+/0x send polygon usdc 100 to Alice
+/0x send base degen 50 to R001
+```
+
+Recipients resolved from kun.py contacts.
+
+### View Addresses
+```bash
+/0x receive
+```
+
+Shows wallet addresses and supported assets.
+
+### Gas Strategy
+```bash
+/0x gas <low|medium|high>
+```
+
+**Levels:**
+- **low**: 80% of current gas
+- **medium**: 100% (default)
+- **high**: 150%
+
+### Add Custom Token
+```bash
+/0x new token <name> <chain> <address>
+```
+
+**Example:**
+```bash
+/0x new token pepe base 0x123...def
+```
+
+### Add Custom Chain
+```bash
+/0x new chain <name> <chain_id> <rpc_url>
+```
+
+**Example:**
+```bash
+/0x new chain avalanche 43114 https://api.avax.network/ext/bc/C/rpc
+```
+
+### Remove Configuration
+```bash
+/0x forget token <name>
+/0x forget chain <name>
+```
+
+**Note:** Base chains (Base, Ethereum, Polygon) cannot be removed.
+
+## 🔧 Configuration
+
+### Required in .env
+```env
+AGENT_PRIVATE_KEY=0x...
+BASE_RPC_URL=https://...
+ETHEREUM_RPC_URL=https://...
+POLYGON_RPC_URL=https://...
+```
+
+### OPSIIE Wallet
+```python
+AGENT_WALLET = {
+    'private_key': AGENT_PRIVATE_KEY,
+    'public_key': '0x89A7f83Db9C1919B89370182002ffE5dfFc03e21'
+}
+```
+
+## 💡 Transaction Flow
+
+1. Parse command intent
+2. Get price quote from DEX
+3. Display preview with USD values
+4. Request confirmation
+5. Execute on-chain
+6. Display explorer link
+
+### Price Quotes
+- Best price from DEX routers
+- Exchange rates calculated
+- USD values shown
+- Slippage tolerance: 0.5%
+
+### DEX Routers
+- **Base**: BaseSwap
+- **Ethereum**: Uniswap V2
+- **Polygon**: QuickSwap
+
+## 🚨 Troubleshooting
+
+**Insufficient balance:** Check wallet funds
+**Transaction failed:** Increase gas, check approvals
+**Invalid address:** Use checksummed addresses
+**RPC error:** Verify RPC URLs in .env
+
+## 🎯 Use Cases
+
+**Token Trading:**
+```bash
+/0x buy 10 degen using eth on base
+/0x sell 5 degen for eth on base
+```
+
+**Transfers:**
+```bash
+/0x send base eth 0.1 to Ross
+```
+
+**Portfolio Management:**
+```bash
+/0x receive  # View holdings
+/0x gas high  # Priority transactions
+```
+
+## 🔐 Security
+
+- Private keys in .env (never commit)
+- Transaction confirmation required
+- Checksummed addresses enforced
+- Gas limit protections
+
+## 📊 Access Control
+
+**R-Grade Required** for all /0x features
+
+---
+
+**Decentralized finance at your command.** 🔗

documentation/api-reference/README.md

@@ -0,0 +1,25 @@
+# API Reference
+
+Technical reference for OPSIIE.
+
+## 📚 Documents
+
+### [Command Reference](command-reference.md)
+Complete command syntax and examples for all features.
+
+### [Error Codes](error-codes.md)
+Common errors and solutions.
+
+## 🔑 Quick Reference
+
+**All Users**: `/recall`, `/memorize`, `/voice`, `/imagine`, `/mail`, `/read`
+**R-Grade**: `/ask`, `/markets`, `/dna`, `/0x`
+
+## 📊 Access
+
+**R-Grade**: ARPA ID R### (full access)
+**A-Grade**: ARPA ID A### (core features only)
+
+---
+
+**Technical reference.** 📚

documentation/api-reference/command-reference.md

@@ -0,0 +1,319 @@
+# Command Reference
+
+Complete reference of all OPSIIE commands.
+
+## 🧠 Memory Commands
+
+### /recall
+**Retrieve relevant memories**
+```bash
+/recall <keyword>
+```
+**Examples**: `/recall project x`, `/recall quantum computing`
+
+### /memorize
+**Store important information**
+```bash
+/memorize <message>
+```
+**Examples**: `/memorize Deadline is Friday`, `/memorize I prefer Python`
+
+### /forget
+**Exclude last interaction from memory**
+```bash
+/forget
+```
+
+### /soulsig
+**Manage Soul Signature**
+```bash
+/soulsig                 # View
+/soulsig <message>       # Add
+/soulsig wipe            # Clear (permanent)
+/soulsig heal            # Restore (if recent)
+```
+
+## 🎤 Voice Commands
+
+### /voice
+**Full voice mode (speak & listen)**
+```bash
+/voice
+```
+Exit: Say "voice off"
+
+### /voice1
+**OPSIIE speaks, you type**
+```bash
+/voice1
+```
+
+### /voice2
+**You speak, OPSIIE types**
+```bash
+/voice2
+```
+
+### /voiceoff
+**Disable voice mode**
+```bash
+/voiceoff
+```
+
+## 🎨 AI Generation Commands
+
+### /imagine
+**Generate images**
+```bash
+/imagine <description>
+/imagine model                    # Check current model
+/imagine model <model_name>       # Change model
+```
+**Examples**: `/imagine futuristic city`, `/imagine model hakurei/waifu-diffusion`
+
+### /video
+**Generate videos**
+```bash
+/video <description>
+/video model                      # Check current model
+/video model <model_name>         # Change model
+```
+**Examples**: `/video sunset timelapse`, `/video model zeroscope`
+
+### /music
+**Generate music**
+```bash
+/music <description>
+```
+**Examples**: `/music jazz piano`, `/music ambient soundscape`
+
+## 📧 Communication Commands
+
+### /mail
+**Send emails**
+```bash
+/mail <emails> subject "<subject>" content "<message>"
+```
+**Examples**: 
+- `/mail john@gmail.com subject "Hello" content "Test"`
+- `/mail Ross subject "Update" content "Latest info"`
+
+### /mail inbox
+**View unread emails**
+```bash
+/mail inbox
+```
+Commands in inbox: number to read, `reply`, `inbox`, `exit`
+
+## 📁 Document Commands
+
+### /read
+**Load and analyze files**
+```bash
+/read "<file_path>"
+```
+Supports: PDF, CSV, DOCX, TXT, XLSX
+**Example**: `/read "C:\Documents\report.pdf"`
+
+### /open
+**Reopen last file context**
+```bash
+/open
+```
+
+### /close
+**Close file context**
+```bash
+/close
+```
+
+## ⚙️ System Commands
+
+### /status
+**System diagnostics**
+```bash
+/status
+```
+
+### /theme
+**Change color theme**
+```bash
+/theme
+```
+Options: Pastel, Vibrant
+
+### /weblimit
+**Set web content extraction limit**
+```bash
+/weblimit <number>
+```
+Range: 500-5000 characters
+**Example**: `/weblimit 2000`
+
+### /help
+**Display help**
+```bash
+/help                    # Main menu
+/help <command>          # Specific command help
+```
+**Examples**: `/help imagine`, `/help markets`
+
+## 🤖 R-Grade: Agentic Network
+
+### /ask
+**Query AI agents**
+```bash
+/ask <agent> <prompt>
+```
+Agents: Nyx, G1, Kronos
+**Examples**:
+- `/ask Nyx Write Python blockchain code`
+- `/ask G1 Analyze quantum computing`
+- `/ask Kronos Greek audit procedures`
+
+### /ask live
+**Live voice conversations**
+```bash
+/ask g1 live             # G1 Black real-time voice
+/ask kronos live         # Kronos real-time voice
+```
+Exit: Press Ctrl+C
+
+### /room
+**Create collaboration room**
+```bash
+/room <agent1, agent2...>: <theme>
+```
+**Examples**:
+- `/room nyx, g1: Quantum computing applications`
+- `/room nyx: Python microservices design`
+
+Close room: `/close` (prompts to save as CSV)
+
+## 📊 R-Grade: Financial Intelligence
+
+### /markets
+**Market data and analysis**
+```bash
+/markets <symbol>                  # Basic data
+/markets <symbol> <extra>          # Detailed analysis
+/markets compare <sym1> <sym2>     # Compare stocks
+```
+
+**Extras**: `statistics`, `history`, `profile`, `financials`, `analysis`, `options`, `holders`, `sustainability`
+
+**Examples**:
+- `/markets tesla`
+- `/markets btc`
+- `/markets shell statistics`
+- `/markets compare tsla nio`
+
+## 🧬 R-Grade: DNA Analysis
+
+### /dna
+**Analyze DNA/RNA/Protein sequences**
+```bash
+/dna <sequence> [options]
+```
+
+**Options**:
+- `--verbose` - Detailed analysis
+- `--type <dna|rna|protein>` - Force type
+- `--format <format>` - Input format
+- `--export <json|csv|txt>` - Export results
+- `--homology` - Include similarity search
+- `--structure` - Structure prediction
+- `--patents` - Patent search
+- `--literature` - Literature search
+
+**Examples**:
+- `/dna ATGCGTAACGGCATTAGC`
+- `/dna --verbose --homology MAKVLISPKQW`
+- `/dna --type rna AUGCGUAACGGCAUUAGC`
+
+## 🔗 R-Grade: Web3 & Blockchain
+
+### /0x buy
+**Buy tokens**
+```bash
+/0x buy <amount> <token> using <token> on <chain>
+```
+**Example**: `/0x buy 10 degen using eth on base`
+
+### /0x sell
+**Sell tokens**
+```bash
+/0x sell <amount> <token> for <token> on <chain>
+```
+**Example**: `/0x sell 5 degen for eth on base`
+
+### /0x send
+**Send tokens**
+```bash
+/0x send <chain> <token> <amount> to <recipient>
+```
+**Example**: `/0x send base eth 0.1 to Ross`
+
+### /0x receive
+**View wallet addresses**
+```bash
+/0x receive
+```
+
+### /0x gas
+**Set gas strategy**
+```bash
+/0x gas <low|medium|high>
+```
+
+### /0x new
+**Add custom token/chain**
+```bash
+/0x new token <name> <chain> <address>
+/0x new chain <name> <chain_id> <rpc_url>
+```
+
+### /0x forget
+**Remove configuration**
+```bash
+/0x forget token <name>
+/0x forget chain <name>
+```
+Note: Cannot remove Base, Ethereum, Polygon
+
+## 🚪 Session Commands
+
+### exit / quit
+**Terminate OPSIIE session**
+```bash
+exit
+quit
+```
+Do not use `/` prefix
+
+## 📋 Command Categories
+
+**All Users:**
+- Memory: `/recall`, `/memorize`, `/forget`, `/soulsig`
+- Voice: `/voice`, `/voice1`, `/voice2`, `/voiceoff`
+- AI Gen: `/imagine`, `/video`, `/music`
+- Email: `/mail`, `/mail inbox`
+- Files: `/read`, `/open`, `/close`
+- System: `/status`, `/theme`, `/weblimit`, `/help`
+
+**R-Grade Only:**
+- Agents: `/ask`, `/ask live`, `/room`
+- Markets: `/markets`
+- DNA: `/dna`
+- Web3: `/0x`
+
+## 🔑 Access Control
+
+**R-Grade**: ARPA ID starts with 'R' (e.g., R001)
+**A-Grade**: ARPA ID starts with 'A' (e.g., A001)
+
+Check kun.py for your access level.
+
+---
+
+**Complete command reference.** 📚

documentation/api-reference/error-codes.md

@@ -0,0 +1,59 @@
+# Error Codes & Troubleshooting
+
+Common OPSIIE errors and solutions.
+
+## 🚨 Authentication
+**Face Recognition Failed**: Check lighting, camera, photo in kun.py
+**Camera Not Detected**: Verify connection, permissions, not in use
+
+## 🔌 Database
+**Connection Failed**: Start PostgreSQL, check .env credentials
+**Table Not Found**: Create conversations table (see installation.md)
+
+## 🎤 Voice
+**Microphone Not Found**: Check connection, Windows default, permissions
+**ElevenLabs API Error**: Verify ELEVENLABS_API_KEY in .env
+**Recognition Failed**: Speak clearly, reduce noise, check internet
+
+## 🤖 AI Models
+**Ollama Not Running**: Start Ollama, `ollama pull llama3`
+**Model Loading (503)**: Wait 2-5 min, retry, or change model
+**GPU Not Available**: Install CUDA, or use CPU (slower)
+
+## 📧 Email
+**SMTP Auth Failed**: Use Gmail app password (not regular password), enable 2FA
+**Cannot Send**: Check internet, Gmail SMTP, recipient addresses
+**IMAP Failed**: Enable IMAP in Gmail, verify credentials
+
+## 📁 Files
+**File Not Found**: Use absolute paths, check exists, quote spaces
+**Unsupported Format**: Use PDF, CSV, DOCX, TXT, XLSX only
+**Extraction Failed**: Check file not corrupted, encoding, password
+
+## 🔗 Web3
+**Insufficient Balance**: Check `/0x receive`, add funds
+**Transaction Failed**: Increase gas `/0x gas high`, check approvals
+**RPC Error**: Verify RPC URLs in .env, check internet
+
+## 🤖 Agents
+**Agent Not Responding**: Check API keys, internet, rate limits
+**Live Mode Failed**: Verify agent IDs in .env, check ElevenLabs
+**Room Creation Failed**: Use correct names (nyx, g1, kronos)
+
+## 📊 Markets
+**Symbol Not Found**: Check ticker spelling on Yahoo Finance
+**Data Timeout**: Retry, check internet, simplify query
+
+## 🧬 DNA
+**Invalid Sequence**: DNA=ATGC, RNA=AUGC, Protein=valid AA, no spaces
+**NCBI Error**: Set NCBI_EMAIL in .env, check internet
+
+## 🔐 Access Control
+**Restricted Command**: R-Grade required, check ARPA ID in kun.py
+
+## 📞 Support
+Email: opsiebyarpa@gmail.com
+
+---
+
+**Quick troubleshooting reference.** 🔧

documentation/core-features/README.md

@@ -0,0 +1,87 @@
+# Core Features
+
+Essential features that form the foundation of OPSIIE's functionality.
+
+## 📚 Feature Overview
+
+### [Memory System](memory.md) 🧠
+Long-term conversation storage and intelligent context retrieval.
+- `/recall` - Retrieve memories
+- `/memorize` - Store information
+- `/forget` - Exclude last interaction
+- `/soulsig` - Manage Soul Signature
+
+### [Voice Interaction](voice.md) 🎤
+Comprehensive voice input/output capabilities.
+- `/voice` - Full voice mode
+- `/voice1` - OPSIIE speaks, you type
+- `/voice2` - You speak, OPSIIE types
+- `/voiceoff` - Disable voice
+- Live conversations with AI agents
+
+### [AI Generation](ai-generation.md) 🎨
+Multi-modal AI content creation.
+- `/imagine` - Generate images
+- `/video` - Generate videos
+- `/music` - Generate music
+- Vision analysis from URLs
+
+### [Communication](communication.md) 📧
+Email management through Gmail integration.
+- `/mail` - Send emails
+- `/mail inbox` - Read inbox
+- Reply to emails
+- Contact name resolution
+
+### [Document Intelligence](document-intelligence.md) 📁
+Intelligent document processing (TAF-3000).
+- `/read` - Load files (PDF, CSV, DOCX, TXT, XLSX)
+- `/open` - Reopen last file
+- `/close` - Close file context
+- Natural language queries
+
+## 🚀 Quick Examples
+
+**Memory:**
+```bash
+/memorize Project deadline is Friday
+/recall project
+```
+
+**Voice:**
+```bash
+/voice
+[speak] "What's the weather?"
+[hear response]
+"voice off"
+```
+
+**AI Generation:**
+```bash
+/imagine futuristic city
+/video sunset timelapse
+/music jazz piano
+```
+
+**Communication:**
+```bash
+/mail john@gmail.com subject "Hello" content "Test"
+/mail inbox
+```
+
+**Documents:**
+```bash
+/read "C:\report.pdf"
+What are the conclusions?
+/close
+```
+
+## 📖 Learn More
+
+- [Memory Management Guide](../user-guides/memory-management.md)
+- [Basic Commands](../user-guides/basic-commands.md)
+- [Command Reference](../api-reference/command-reference.md)
+
+---
+
+**Master these core features to unlock OPSIIE's full potential.** ✨

documentation/core-features/ai-generation.md

@@ -0,0 +1,555 @@
+# AI Generation - Multi-Modal Creation
+
+OPSIIE provides multi-modal AI generation capabilities for images, videos, and music using various AI models and APIs.
+
+## 🎨 Overview
+
+AI Generation features:
+- **Image Generation**: AI-powered image creation via Hugging Face models
+- **Video Generation**: Text-to-video synthesis with multiple models
+- **Music Generation**: AI music composition using Facebook's MusicGen
+- **Model Flexibility**: Switch between different AI models
+- **Local & API-Based**: Mix of local and cloud-based generation
+
+## 🖼️ Image Generation
+
+### /imagine Command
+Generate images from text descriptions.
+
+**Syntax:**
+```bash
+/imagine <description>
+```
+
+**Examples:**
+```bash
+# Sci-fi scenes
+/imagine a futuristic city skyline at sunset
+
+# Character portraits
+/imagine portrait of a cyberpunk hacker
+
+# Abstract art
+/imagine abstract digital art with purple and blue colors
+
+# Landscapes
+/imagine mountain landscape with aurora borealis
+
+# Anime style
+/imagine anime girl in school uniform
+```
+
+### How It Works
+1. Text prompt sent to Hugging Face Inference API
+2. Image generated by selected model
+3. Image saved to `outputs/images/`
+4. Image automatically displayed
+5. Filename created from prompt
+
+**Output:**
+```
+OPSIIE is dreaming... do not disturb.
+Image generated and saved as 'outputs/images/futuristic_city_skyline_at_sunset.png'
+```
+
+### Model Management
+
+**Check Current Model:**
+```bash
+/imagine model
+```
+
+**Output:**
+```
+Current dream engine model is: black-forest-labs/FLUX.1-dev
+To change the model, use /imagine model <new_model_name>
+```
+
+**Change Model:**
+```bash
+/imagine model <model_name>
+```
+
+**Available Models:**
+```bash
+# FLUX (default - high quality)
+/imagine model black-forest-labs/FLUX.1-dev
+
+# Anime/Waifu style
+/imagine model hakurei/waifu-diffusion
+
+# NSFW capable (use responsibly)
+/imagine model UnfilteredAI/NSFW-gen-v2
+
+# Any Hugging Face model
+/imagine model <username>/<model-name>
+```
+
+**Configuration:**
+```python
+# Default model
+HF_API_URL = "https://api-inference.huggingface.co/models/black-forest-labs/FLUX.1-dev"
+
+# Requires Hugging Face API token in headers
+```
+
+### Image Generation Features
+- **Auto-save**: Images saved to `outputs/images/`
+- **Auto-display**: Images automatically opened
+- **Clean filenames**: Prompt converted to filename
+- **Format**: PNG (default)
+- **API**: Hugging Face Inference API
+
+### Error Handling
+```
+Error: The dream engine model is still loading
+→ Model needs warm-up time, retry in few minutes
+
+Error: 503 Service Unavailable
+→ Model temporarily unavailable, try different model
+
+Error: The content returned is not a valid image
+→ Invalid response from API, retry or change model
+```
+
+## 🎬 Video Generation
+
+### /video Command
+Generate videos from text descriptions.
+
+**Syntax:**
+```bash
+/video <description>
+```
+
+**Examples:**
+```bash
+# Nature scenes
+/video sunset timelapse over ocean waves
+
+# Action sequences
+/video cat playing with yarn ball
+
+# Abstract visuals
+/video abstract particles flowing in space
+
+# Landscapes
+/video mountain landscape with moving clouds
+```
+
+### How It Works
+1. Text prompt processed by video diffusion model
+2. Video frames generated (24 frames default)
+3. Frames compiled into MP4 video
+4. Video saved to `outputs/videos/`
+5. Video automatically plays in browser
+
+**Default Parameters:**
+```python
+{
+    "num_frames": 24,
+    "height": 256,
+    "width": 256,
+    "num_inference_steps": 20,
+    "guidance_scale": 7.5
+}
+```
+
+### Video Models
+
+**Check Current Model:**
+```bash
+/video model
+```
+
+**Change Model:**
+```bash
+/video model <model_name>
+```
+
+**Available Models:**
+```bash
+# ModelScope (default)
+/video model modelscope
+
+# Zeroscope (higher quality)
+/video model zeroscope
+
+# VideoGen
+/video model videogen
+
+# TuneAVideo
+/video model tuneavideo
+```
+
+**Model Details:**
+```python
+VIDEO_MODELS = {
+    "modelscope": "damo-vilab/text-to-video-ms-1.7b",
+    "zeroscope": "cerspense/zeroscope_v2_576w",
+    "videogen": "VideoCrafter/videogen-1",
+    "tuneavideo": "tuneavideo/stable-diffusion-v1-5-video"
+}
+```
+
+### Video Generation Process
+```
+OPSIIE is dreaming... do not disturb.
+[Generating 24 frames...]
+[Compiling video...]
+Video specimen generated and saved to: outputs/videos/sunset_timelapse.mp4
+[Video plays in browser]
+```
+
+### Video Features
+- **Resolution**: 256x256 (default, model-dependent)
+- **Duration**: 24 frames (~1 second at 24fps)
+- **Format**: MP4
+- **Auto-play**: Opens in default browser
+- **CUDA Support**: GPU acceleration if available
+
+## 🎵 Music Generation
+
+### /music Command
+Generate music from text descriptions.
+
+**Syntax:**
+```bash
+/music <description>
+```
+
+**Examples:**
+```bash
+# Classical
+/music calm piano with soft strings
+
+# Electronic
+/music electronic dance music with heavy bass
+
+# Jazz
+/music smooth jazz with saxophone
+
+# Ambient
+/music ambient soundscape for meditation
+
+# Rock
+/music energetic rock guitar solo
+```
+
+### How It Works
+1. Text prompt processed by MusicGen model
+2. Audio waveform generated
+3. Audio saved as WAV file
+4. Audio saved to `outputs/music/`
+5. Audio automatically played
+
+**Model:**
+```python
+# Facebook's MusicGen Small
+musicgen_processor = AutoProcessor.from_pretrained("facebook/musicgen-small")
+musicgen_model = MusicgenForConditionalGeneration.from_pretrained(
+    "facebook/musicgen-small", 
+    attn_implementation="eager"
+)
+```
+
+### Music Generation Process
+```
+OPSIIE is dreaming... do not disturb.
+[Processing prompt...]
+[Generating audio waveform...]
+[Saving to WAV...]
+Music specimen generated: outputs/music/calm_piano_with_soft_strings.wav
+[Audio plays]
+```
+
+### Music Features
+- **Model**: facebook/musicgen-small
+- **Format**: WAV
+- **Quality**: Model-dependent
+- **Auto-play**: pygame mixer
+- **CUDA Support**: GPU acceleration
+- **Duration**: Configurable (model default)
+
+## 🎨 Vision Analysis
+
+### Image URL Analysis
+OPSIIE can analyze images from URLs in conversations.
+
+**How to Use:**
+```
+Provide image URL in your prompt, OPSIIE analyzes and describes it
+```
+
+**Example:**
+```
+You: What do you see in this image? https://example.com/image.jpg
+
+OPSIIE: [Downloads image]
+        [Analyzes with BLIP model]
+        [Provides description]
+        I see a futuristic cityscape with tall buildings...
+```
+
+### Vision Model
+```python
+# BLIP model for image captioning
+processor = BlipProcessor.from_pretrained("Salesforce/blip-image-captioning-base")
+model = BlipForConditionalGeneration.from_pretrained("Salesforce/blip-image-captioning-base")
+```
+
+**Features:**
+- Automatic image download from URLs
+- Image analysis and description
+- Context integration in responses
+- Supports common image formats
+
+## 🔧 Technical Architecture
+
+### Image Pipeline
+```
+Text Prompt → HF API → Model Processing → Image Generation → PNG Save → Display
+```
+
+### Video Pipeline
+```
+Text Prompt → Diffusion Model → Frame Generation → Video Compilation → MP4 Save → Browser Play
+```
+
+### Music Pipeline
+```
+Text Prompt → MusicGen → Waveform Generation → WAV Save → Audio Play
+```
+
+### Vision Pipeline
+```
+Image URL → Download → BLIP Model → Description → Context Integration
+```
+
+## 💡 Best Practices
+
+### Effective Prompts
+
+**Images:**
+```bash
+# Be specific
+/imagine cyberpunk hacker in neon-lit room with holographic displays
+
+# Include style
+/imagine oil painting of mountain landscape in impressionist style
+
+# Specify details
+/imagine portrait of woman with blue eyes, long hair, futuristic clothing
+```
+
+**Videos:**
+```bash
+# Describe motion
+/video waves crashing on beach with sunset
+
+# Be concise (video models prefer shorter prompts)
+/video cat playing with ball
+
+# Focus on main action
+/video abstract particles swirling
+```
+
+**Music:**
+```bash
+# Specify genre and mood
+/music upbeat jazz with piano and drums
+
+# Include instruments
+/music classical symphony with strings and brass
+
+# Describe atmosphere
+/music dark ambient with deep bass
+```
+
+### Resource Management
+
+**GPU Usage:**
+- Image generation: API-based (no local GPU needed)
+- Video generation: Local GPU recommended
+- Music generation: Local GPU recommended
+
+**Storage:**
+- Images: ~1-5 MB each
+- Videos: ~5-20 MB each
+- Music: ~2-10 MB each
+- Monitor `outputs/` directory size
+
+**Performance:**
+- Image: ~10-30 seconds (API dependent)
+- Video: ~1-5 minutes (GPU dependent)
+- Music: ~30-60 seconds (GPU dependent)
+
+## ⚙️ Configuration
+
+### API Keys
+```env
+# Hugging Face (for image generation)
+HF_API_TOKEN=your_hugging_face_token
+```
+
+### Model Settings
+```python
+# Image model (changeable via command)
+HF_API_URL = "https://api-inference.huggingface.co/models/black-forest-labs/FLUX.1-dev"
+
+# Video model (changeable via command)
+current_model = "modelscope"
+
+# Music model (fixed)
+model = "facebook/musicgen-small"
+
+# Vision model (fixed)
+model = "Salesforce/blip-image-captioning-base"
+```
+
+### Output Directories
+```python
+ensure_directory_exists('outputs/images')
+ensure_directory_exists('outputs/music')
+ensure_directory_exists('outputs/videos')
+```
+
+## 🚨 Troubleshooting
+
+### Image Generation Fails
+```
+Error: Model is loading (503)
+→ Wait a few minutes, retry
+
+Error: Invalid API token
+→ Check HF_API_TOKEN in environment
+
+Error: Rate limit exceeded
+→ Wait or use different model
+```
+
+### Video Generation Slow
+```
+Problem: Takes very long time
+→ Check GPU availability
+→ Try smaller model (modelscope vs zeroscope)
+→ Reduce num_frames parameter
+```
+
+### Music Generation Issues
+```
+Error: Model not initialized
+→ Check CUDA availability
+→ Verify model download
+→ Check disk space
+
+Error: Audio playback failed
+→ Check audio drivers
+→ Verify pygame installation
+```
+
+### Vision Analysis Fails
+```
+Error: Could not download image
+→ Check URL validity
+→ Verify internet connection
+→ Check image format support
+```
+
+## 🎯 Use Cases
+
+### Creative Projects
+```bash
+# Generate concept art
+/imagine futuristic vehicle design
+
+# Create mood videos
+/video abstract visuals for presentation
+
+# Produce background music
+/music ambient music for podcast intro
+```
+
+### Research & Development
+```bash
+# Visualize concepts
+/imagine diagram of neural network architecture
+
+# Create demo videos
+/video simulation of particle movement
+
+# Generate test audio
+/music various musical styles for testing
+```
+
+### Content Creation
+```bash
+# Social media content
+/imagine eye-catching thumbnail design
+
+# Video content
+/video intro sequence animation
+
+# Podcast music
+/music podcast outro music
+```
+
+## 📊 Generation Statistics
+
+Check system status:
+```bash
+/status
+```
+
+Shows:
+- Generation system status
+- Model availability
+- GPU/CPU usage
+- Output directory sizes
+
+## 🚀 Advanced Usage
+
+### Batch Generation
+```bash
+# Generate multiple images
+/imagine concept 1
+/imagine concept 2
+/imagine concept 3
+
+# Generate video sequences
+/video scene 1
+/video scene 2
+/video scene 3
+```
+
+### Model Experimentation
+```bash
+# Try different image models
+/imagine model FLUX.1-dev
+/imagine futuristic city
+/imagine model waifu-diffusion
+/imagine anime character
+/imagine model stable-diffusion-v1-5
+/imagine realistic portrait
+```
+
+### Workflow Integration
+```bash
+# Create complete content
+/imagine concept art for video game
+/video game intro animation
+/music epic game soundtrack
+
+# All outputs saved to respective directories
+```
+
+## 📚 Related Features
+
+- **Voice Generation**: ElevenLabs for voice synthesis
+- **File Processing**: Analyze generated images with `/read`
+- **Memory**: Store generation prompts with `/memorize`
+- **Rooms**: Collaborative generation with AI agents
+
+---
+
+**Multi-modal AI generation brings creativity to your fingertips.** 🎨

documentation/core-features/communication.md

@@ -0,0 +1,107 @@
+# Communication - Email Management
+
+OPSIIE provides comprehensive email capabilities through Gmail integration for sending, receiving, and managing emails.
+
+## 📧 Overview
+
+- **Send Emails**: Natural language email composition
+- **Read Inbox**: View unread messages
+- **Reply**: Respond to emails
+- **Multi-Recipient**: Up to 5 recipients
+- **Contact Mapping**: Automatic name resolution from kun.py
+- **HTML Templates**: Professional ARPA-branded emails
+
+## 📤 Sending Emails
+
+### /mail Command
+
+**Basic Syntax:**
+```bash
+/mail <emails> subject "<subject>" content "<message>"
+```
+
+**Examples:**
+```bash
+# Single recipient
+/mail john@gmail.com subject "Meeting" content "Let's meet at 2 PM"
+
+# Multiple recipients
+/mail john@gmail.com and alice@example.com subject "Update" content "Here's the info"
+
+# Using contact names
+/mail Ross subject "Hello" content "How are you?"
+```
+
+### Email Parsing
+
+OPSIIE extracts:
+- **Email Addresses**: `name@domain.com` format
+- **Contact Names**: From kun.py profiles
+- **Subject**: Keywords: subject, sub, theme, title
+- **Content**: Keywords: content, body, message, saying
+
+### Contact Resolution
+
+Names automatically map to emails from kun.py:
+```python
+'Ross': {'mail': 'ross@example.com'}
+```
+
+## 📥 Reading Emails
+
+### /mail inbox
+
+View unread emails:
+```bash
+/mail inbox
+```
+
+**Select email number to read:**
+```
+[INPUT] Select email number or 'exit': 1
+```
+
+**Commands in email view:**
+- `reply` - Reply to email
+- `inbox` - Return to inbox list  
+- `exit` - Return to main interface
+
+## 💬 Replying
+
+1. Open email from inbox
+2. Type `reply`
+3. Compose message
+4. Reply sent with "Re:" prefix
+
+## 🔧 Configuration
+
+**Gmail Setup:**
+1. Enable 2-Factor Authentication
+2. Generate App Password
+3. Configure .env:
+
+```env
+SENDER_EMAIL=your_email@gmail.com
+SENDER_PASSWORD=your_app_password
+```
+
+## 🚨 Troubleshooting
+
+**Authentication Failed:**
+- Use app password, not regular password
+- Enable 2FA
+- Regenerate app password
+
+**Cannot Send:**
+- Check internet connection
+- Verify Gmail SMTP access
+- Check recipient addresses
+
+**Cannot Read Inbox:**
+- Enable IMAP in Gmail
+- Verify credentials
+- Check connection
+
+---
+
+**OPSIIE keeps you connected.** 📧

documentation/core-features/document-intelligence.md

@@ -0,0 +1,75 @@
+# Document Intelligence - TAF-3000
+
+OPSIIE's File Manager TAF-3000 provides intelligent document processing with natural language querying.
+
+## 📁 Overview
+
+- **Formats**: PDF, CSV, DOCX, TXT, XLSX
+- **Analysis**: Intelligent parsing and extraction
+- **Queries**: Ask questions about content
+- **Context**: Maintains file context
+- **AI**: Uses Ollama/Llama3 for responses
+
+## 📖 Commands
+
+### /read - Load File
+```bash
+/read "<file_path>"
+```
+
+**Examples:**
+```bash
+/read "C:\Documents\report.pdf"
+/read "E:\Data\sales.csv"
+/read "C:\Notes\meeting.docx"
+```
+
+### Ask Questions
+After loading, ask naturally:
+```
+What are the main conclusions?
+Which product had highest sales?
+Summarize the methodology
+```
+
+### /open - Reopen Last File
+```bash
+/open
+```
+
+### /close - Close Context
+```bash
+/close
+```
+
+## 📊 Supported Formats
+
+- **PDF**: PyPDF2, pdfplumber
+- **CSV**: pandas
+- **DOCX**: python-docx
+- **TXT**: built-in
+- **XLSX**: pandas
+
+## 💡 Best Practices
+
+**Use full paths:**
+```bash
+✅ /read "C:\Users\Name\file.pdf"
+❌ /read "file.pdf"
+```
+
+**Be specific in queries:**
+```
+✅ "What does section 3 say about revenue?"
+❌ "Tell me about it"
+```
+
+## 🚨 Troubleshooting
+
+**File not found:** Check path, use absolute paths
+**Unsupported format:** Only PDF, CSV, DOCX, TXT, XLSX
+**Query fails:** Rephrase, be more specific
+
+---
+
+**TAF-3000 makes documents intelligible.** 📁

documentation/core-features/memory.md

@@ -0,0 +1,498 @@
+# Memory System - Mnemonic Matrix
+
+OPSIIE's memory system, called the Mnemonic Matrix, provides long-term conversation storage and intelligent context retrieval using PostgreSQL and ChromaDB.
+
+## 🧠 Overview
+
+The Mnemonic Matrix enables OPSIIE to:
+- **Remember Past Conversations**: Store all interactions in PostgreSQL
+- **Retrieve Relevant Context**: Use vector search to find related memories
+- **Build Ongoing Relationships**: Reference previous discussions
+- **Maintain User Preferences**: Store and recall your Soul Signature
+- **Learn from Interactions**: Improve responses based on history
+
+## 🔧 Architecture
+
+### Database Structure
+
+**PostgreSQL (mnemonic_computer)**
+```sql
+CREATE TABLE conversations (
+    id SERIAL PRIMARY KEY,
+    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    prompt TEXT NOT NULL,
+    response TEXT NOT NULL
+);
+```
+
+**ChromaDB (Vector Database)**
+- Stores conversation embeddings
+- Enables semantic search
+- Finds contextually similar memories
+
+### How It Works
+
+1. **Storage**: Every conversation is stored in PostgreSQL
+2. **Vectorization**: Text is converted to embeddings
+3. **Indexing**: Embeddings stored in ChromaDB
+4. **Retrieval**: Semantic search finds relevant memories
+5. **Context**: Retrieved memories enhance AI responses
+
+## 📝 Memory Commands
+
+### /memorize - Store Information
+Store important information for future reference.
+
+**Syntax:**
+```bash
+/memorize <message>
+```
+
+**Examples:**
+```bash
+# Store personal information
+/memorize My favorite programming language is Python
+
+# Store project details
+/memorize The project deadline is next Friday at 5 PM
+
+# Store preferences
+/memorize I prefer technical explanations with code examples
+
+# Store reminders
+/memorize Don't forget to review the pull request
+
+# Store research notes
+/memorize Quantum entanglement relates to our AI architecture discussion
+```
+
+**What Happens:**
+1. Message stored in PostgreSQL
+2. Embedding created and stored in ChromaDB
+3. Available for future /recall queries
+4. OPSIIE can reference it in conversations
+
+### /recall - Retrieve Information
+Pull relevant context from past conversations.
+
+**Syntax:**
+```bash
+/recall <keyword>
+```
+
+**Examples:**
+```bash
+# Recall by topic
+/recall project x
+
+# Recall by date context
+/recall last week discussion
+
+# Recall by person
+/recall meeting with John
+
+# Recall by technology
+/recall quantum computing
+
+# Recall by preference
+/recall my preferences
+```
+
+**What Happens:**
+1. Semantic search in ChromaDB
+2. Finds contextually similar memories
+3. Retrieves top relevant conversations
+4. Displays results with timestamps
+5. OPSIIE uses context in next response
+
+**Example Output:**
+```
+Retrieved Memories:
+
+[2025-01-15 14:23] 
+Prompt: Tell me about project x
+Response: Project X is the quantum computing initiative we discussed...
+
+[2025-01-10 09:45]
+Prompt: /memorize Project X deadline is March 15
+Response: I've stored that information...
+
+Found 2 relevant memories for 'project x'
+```
+
+### /forget - Exclude Last Interaction
+Prevent the last conversation from being stored.
+
+**Syntax:**
+```bash
+/forget
+```
+
+**Use Cases:**
+```bash
+# After inaccurate response
+OPSIIE >> [incorrect information]
+You >> /forget
+
+# After hallucination
+OPSIIE >> [hallucinated content]
+You >> /forget
+
+# After testing
+You >> test command
+OPSIIE >> [response]
+You >> /forget
+
+# After private information
+You >> [sensitive data]
+OPSIIE >> [response]
+You >> /forget
+```
+
+**What Happens:**
+1. Last prompt-response pair removed from memory
+2. NOT stored in PostgreSQL
+3. NOT stored in ChromaDB
+4. Fresh start for next interaction
+
+**Important**: 
+- Only affects the most recent interaction
+- Cannot undo after next prompt
+- Use immediately after unwanted response
+
+## 🎯 Soul Signature System
+
+The Soul Signature is your personalized system prompt with highest priority in OPSIIE's context hierarchy.
+
+### View Soul Signature
+```bash
+/soulsig
+```
+
+Displays your current Soul Signature from kun.py.
+
+### Add to Soul Signature
+```bash
+/soulsig <message>
+```
+
+**Examples:**
+```bash
+# Communication style
+/soulsig I prefer direct communication without pleasantries
+
+# Preferences
+/soulsig My favorite color is Lilac
+
+# Instructions
+/soulsig Do not reply using my middle name
+
+# Context
+/soulsig I'm currently working on a blockchain project
+
+# Roles
+/soulsig You are my physics lecturer
+```
+
+**What Happens:**
+1. Message appended to your soul_sig in kun.py
+2. Automatically included in all future conversations
+3. OPSIIE prioritizes this information
+4. Persists across sessions
+
+### Wipe Soul Signature
+```bash
+/soulsig wipe
+```
+
+**⚠️ WARNING**: This permanently deletes your Soul Signature from kun.py
+
+**Before Wiping:**
+1. Soul Signature copied to temporary storage
+2. Can be restored with `/soulsig heal` if done immediately
+
+### Restore Soul Signature
+```bash
+/soulsig heal
+```
+
+Restores Soul Signature from temporary storage (only if recently wiped).
+
+## 💡 Best Practices
+
+### Effective Memorization
+
+**DO:**
+```bash
+# Be specific
+/memorize Project Alpha uses TensorFlow 2.x and PyTorch
+
+# Include context
+/memorize Meeting with Sarah on 2025-01-20 discussed budget concerns
+
+# Store preferences clearly
+/memorize I prefer code examples in Python with type hints
+
+# Save important dates
+/memorize Annual review scheduled for March 15, 2025
+```
+
+**DON'T:**
+```bash
+# Too vague
+/memorize something important
+
+# No context
+/memorize tomorrow
+
+# Redundant
+/memorize (if already in conversation)
+```
+
+### Effective Recall
+
+**DO:**
+```bash
+# Use specific keywords
+/recall quantum entanglement discussion
+
+# Reference timeframes
+/recall last month's project discussion
+
+# Use topics
+/recall machine learning architecture
+
+# Reference people
+/recall conversation with Alice
+```
+
+**DON'T:**
+```bash
+# Too generic
+/recall stuff
+
+# Single letters
+/recall a
+
+# Empty
+/recall
+```
+
+### Soul Signature Management
+
+**Include:**
+- Communication style preferences
+- Areas of expertise and interest
+- Personal preferences
+- Contextual information
+- Specific instructions
+
+**Example Soul Signature:**
+```python
+'soul_sig': [
+    "Prefers direct, technical communication",
+    "Background in quantum physics and ML",
+    "Working on AI ethics research",
+    "Enjoys sarcastic humor",
+    "Prefers Python code examples",
+    "Do not use formal titles",
+    "My favorite color is Lilac",
+    "Currently based in Athens, Greece",
+    "Interested in blockchain applications in science"
+]
+```
+
+## 🔍 How Memory Enhances Conversations
+
+### Context Building
+```
+You: Tell me about neural networks
+OPSIIE: Based on our previous discussions about quantum computing, 
+        I'll connect this to our conversation last week about 
+        quantum neural networks...
+```
+
+### Preference Recall
+```
+You: Explain gradient descent
+OPSIIE: [Provides technical explanation with Python code, 
+         remembering your Soul Signature preference for 
+         code examples]
+```
+
+### Long-term Learning
+```
+You: What did we discuss about the project timeline?
+OPSIIE: *recalls /memorize from 2 weeks ago*
+        You mentioned the deadline is March 15, and we 
+        discussed the three-phase approach...
+```
+
+## 📊 Memory Statistics
+
+### View Memory Usage
+```bash
+/status
+```
+
+Shows:
+- Total conversations stored
+- Database size
+- Vector database status
+- Memory usage
+
+## 🔐 Privacy & Security
+
+### What's Stored
+- All conversation prompts and responses
+- Timestamps for each interaction
+- Vector embeddings for semantic search
+- Soul Signature preferences
+
+### What's NOT Stored
+- Conversations after `/forget`
+- Temporary file context (after `/close`)
+- Live voice conversations (unless explicitly requested)
+
+### Data Isolation
+- Each user has separate database connection (configured in kun.py)
+- Users can only access their own memories
+- R-Grade and A-Grade users are segregated
+
+### Data Control
+```bash
+# Remove last interaction
+/forget
+
+# Wipe personal preferences
+/soulsig wipe
+
+# Database is local - you have full control
+```
+
+## 🧬 Technical Details
+
+### Vector Embeddings
+- Model: `sentence-transformers/all-MiniLM-L6-v2`
+- Dimension: 384
+- Similarity: Cosine similarity
+- Threshold: Configurable
+
+### Storage Optimization
+- Conversation deduplication
+- Automatic pruning (configurable)
+- Efficient indexing
+- Compressed embeddings
+
+### Retrieval Algorithm
+1. Query vectorization
+2. Semantic search in ChromaDB
+3. Top-k results selection (default k=5)
+4. Relevance ranking
+5. Context injection into prompt
+
+## ⚠️ Limitations
+
+### Current Limitations
+- No conversation editing after storage
+- `/forget` only works for last interaction
+- Soul Signature changes require editing kun.py directly (except `/soulsig` append)
+- No memory export feature (direct database access required)
+- No automatic memory summarization
+
+### Workarounds
+```bash
+# To update stored information
+/memorize [Updated information] (overwrites in practice via relevance)
+
+# To clear specific memories
+# Requires direct database access
+DELETE FROM conversations WHERE prompt LIKE '%specific topic%';
+```
+
+## 🚀 Advanced Usage
+
+### Memory-Driven Workflows
+
+**Research Assistant**
+```bash
+# Store research findings
+/memorize Paper X shows quantum advantage in specific algorithms
+
+# Recall during writing
+/recall quantum advantage
+
+# Build knowledge base over time
+```
+
+**Project Management**
+```bash
+# Store milestones
+/memorize Phase 1 completed on 2025-01-20
+
+# Track decisions
+/memorize Team decided to use microservices architecture
+
+# Recall history
+/recall project decisions
+```
+
+**Personal Knowledge Base**
+```bash
+# Store learning
+/memorize Neural network backpropagation uses chain rule
+
+# Recall concepts
+/recall backpropagation
+
+# Build on previous knowledge
+Explains based on what you've already learned
+```
+
+## 📚 Related Features
+
+- **File Context** (`/read`, `/open`, `/close`): Temporary file-based memory
+- **Room History** (`/room`): Conversation history in multi-agent rooms
+- **Command History**: Terminal-level history (not in memory system)
+
+## 🔧 Troubleshooting
+
+### Memory Not Recalled
+```
+Problem: /recall returns no results
+Solutions:
+- Check keyword spelling
+- Try broader keywords
+- Verify conversation was not /forgotten
+- Check database connection (/status)
+```
+
+### Slow Recall
+```
+Problem: /recall takes long time
+Solutions:
+- Large database needs optimization
+- Check database performance
+- Consider pruning old conversations
+```
+
+### Soul Signature Not Applied
+```
+Problem: OPSIIE ignores Soul Signature
+Solutions:
+- Verify kun.py has correct soul_sig
+- Restart OPSIIE to reload
+- Check for syntax errors in soul_sig list
+```
+
+## 📞 Support
+
+For memory system issues:
+- Check database connection with `/status`
+- Verify PostgreSQL is running
+- Review kun.py configuration
+- Contact: opsiebyarpa@gmail.com
+
+---
+
+**The Mnemonic Matrix is the foundation of OPSIIE's long-term intelligence and personalization.** 🧠

documentation/core-features/voice.md

@@ -0,0 +1,502 @@
+# Voice Interaction System
+
+OPSIIE's voice system provides comprehensive voice input/output capabilities using ElevenLabs for synthesis and Google Speech Recognition for input.
+
+## 🎤 Overview
+
+Voice capabilities include:
+- **Full Voice Mode**: Both speak and listen
+- **Voice Output Only**: OPSIIE speaks, you type
+- **Voice Input Only**: You speak, OPSIIE types
+- **Multi-Agent Voices**: Different voices for Nyx, G1, and OPSIIE
+- **Voice Commands**: Natural language command detection
+- **Live Voice Conversations**: Real-time voice chat with AI agents
+
+## 🔧 Voice Modes
+
+### /voice - Full Voice Mode
+**Both speak and listen**
+
+```bash
+/voice
+```
+
+**Features:**
+- OPSIIE speaks responses using ElevenLabs
+- You speak commands/queries
+- Natural conversation flow
+- 20-second inactivity timeout
+- Automatic voice command detection
+
+**How to Use:**
+1. Type `/voice` or say "voice"
+2. Wait for activation confirmation
+3. Speak naturally
+4. OPSIIE responds with voice
+5. Continue conversation
+6. Say "voice off" or "exit voice mode" to deactivate
+
+**Example Session:**
+```
+You: /voice
+OPSIIE: "Verbal communication protocol established."
+
+You: [speak] "What's the weather like?"
+OPSIIE: [speaks response]
+
+You: [speak] "voice off"
+OPSIIE: "Verbal communication protocol bridge collapsed successfully."
+```
+
+### /voice1 - OPSIIE Speaks, You Type
+**Output-only voice mode**
+
+```bash
+/voice1
+```
+
+**Use Cases:**
+- Want to hear responses
+- Prefer typing for accuracy
+- Noisy environment
+- Hands-free response consumption
+
+**Example:**
+```
+You: /voice1
+OPSIIE: [speaks] "Voice output mode activated."
+
+You: [type] Tell me about quantum computing
+OPSIIE: [speaks response]
+
+You: /voiceoff
+```
+
+### /voice2 - You Speak, OPSIIE Types
+**Input-only voice mode**
+
+```bash
+/voice2
+```
+
+**Use Cases:**
+- Hands-free input
+- Faster than typing
+- Accessibility
+- Quiet environment for reading
+
+**Example:**
+```
+You: /voice2
+OPSIIE: Voice input mode activated.
+
+You: [speak] "Explain neural networks"
+OPSIIE: [types response]
+
+You: /voiceoff
+```
+
+### /voiceoff - Disable Voice Mode
+**Deactivate all voice features**
+
+```bash
+/voiceoff
+```
+
+Or voice command:
+```
+"voice off"
+"exit voice mode"
+```
+
+## 🗣️ Voice Commands
+
+### Natural Language Detection
+Voice mode automatically detects command intent from natural speech:
+
+**Memory Commands:**
+```
+"recall my last project"           → /recall last project
+"memorize this is important"       → /memorize this is important
+```
+
+**System Commands:**
+```
+"status"                           → /status
+"help"                             → /help
+"theme"                            → /theme (opens theme selector)
+```
+
+**AI Generation:**
+```
+"imagine a futuristic city"        → /imagine a futuristic city
+"generate music jazz piano"        → /music jazz piano
+"create video of sunset"           → /video sunset
+```
+
+**File Operations:**
+```
+"read the file report.pdf"         → /read "report.pdf"
+"open the document"                → /open
+"close file context"               → /close
+```
+
+### Voice Command Examples
+```bash
+# Works in voice mode:
+You: [speak] "recall our discussion about AI"
+OPSIIE: [executes /recall] [speaks results]
+
+You: [speak] "memorize project deadline is Friday"
+OPSIIE: [executes /memorize] [confirms]
+
+You: [speak] "show me system status"
+OPSIIE: [executes /status] [displays status]
+
+You: [speak] "imagine a cyberpunk cityscape"
+OPSIIE: [executes /imagine] [generates image] [confirms]
+```
+
+## 🎭 Multi-Agent Voices
+
+### Agent Voice Configuration
+Each AI agent has a unique voice configured via ElevenLabs:
+
+```env
+# .env configuration
+VOICE_ID=your_opsiie_voice_id        # OPSIIE's voice
+NYX_VOICE_ID=your_nyx_voice_id       # Nyx's voice
+G1_VOICE_ID=your_g1_voice_id         # G1 Black's voice
+```
+
+### Agent Voice Usage
+
+**OPSIIE Voice:**
+```bash
+# Default for all OPSIIE responses
+You: Tell me about AI
+OPSIIE: [responds in OPSIIE voice]
+```
+
+**Nyx Voice:**
+```bash
+/ask Nyx What are the latest quantum computing developments?
+# Nyx responds in Nyx's voice (if voice mode active)
+```
+
+**G1 Black Voice:**
+```bash
+/ask G1 Analyze this technical problem
+# G1 responds in G1's voice (if voice mode active)
+```
+
+## 📞 Live Voice Conversations
+
+### G1 Live Voice
+**Real-time voice conversation with G1 Black**
+
+```bash
+/ask g1 live
+```
+
+**Features:**
+- Direct WebSocket connection to ElevenLabs
+- Real-time audio streaming
+- Continuous conversation
+- Press Ctrl+C to end
+
+**How It Works:**
+1. Establishes WebSocket connection
+2. Starts audio input/output streams
+3. You speak, G1 responds immediately
+4. Continues until manually stopped
+
+**Example Session:**
+```
+You: /ask g1 live
+
+[System]: Live conversation with G1 Black initialized.
+[System]: Speak naturally. Press Ctrl+C to end the conversation.
+
+You: [speak] What's happening with Bitcoin?
+G1 Black: [responds in real-time]
+
+You: [speak] And what about Ethereum?
+G1 Black: [responds immediately]
+
+[Press Ctrl+C]
+[System]: Ending live conversation...
+[System]: Live conversation session concluded.
+```
+
+### Kronos Live Voice
+**Live conversation with Kronos (Greek Internal Auditor)**
+
+```bash
+/ask kronos live
+```
+
+Similar to G1 live mode, specialized for Greek internal auditing.
+
+## 🔊 Voice Synthesis (ElevenLabs)
+
+### Configuration
+```env
+ELEVENLABS_API_KEY=your_api_key
+VOICE_ID=your_voice_id
+```
+
+### How It Works
+1. Text response generated by OPSIIE
+2. Sent to ElevenLabs API
+3. Audio synthesized with specified voice
+4. Streamed and played back
+5. Temporary file cleaned up
+
+### Voice Parameters
+- **Optimize Streaming**: Latency=3 (fastest)
+- **Format**: MP3
+- **Playback**: pygame.mixer
+- **Cleanup**: Automatic temp file deletion
+
+### API Verification
+OPSIIE verifies ElevenLabs API on startup:
+```
+Checking Eleven Labs API access... ✓
+```
+
+## 🎧 Speech Recognition (Google)
+
+### How It Works
+1. Microphone captures audio
+2. Google Speech API transcribes
+3. Text processed as command/query
+4. OPSIIE responds
+
+### Recognition Settings
+- **Engine**: Google Speech Recognition
+- **Language**: English (default)
+- **Timeout**: 20 seconds inactivity
+- **Format**: 16-bit PCM
+
+### Microphone Configuration
+```python
+recognizer = sr.Recognizer()
+mic = sr.Microphone()
+```
+
+### Custom Word Recognition
+OPSIIE has enhanced recognition for specific phrases:
+
+**Custom Audio Patterns:**
+```python
+custom_words = {
+    "Opsie": [...],
+    "Voice off": [...],
+    "send Base Degen": [...],
+    # ... custom patterns
+}
+```
+
+Uses MFCC (Mel-frequency cepstral coefficients) for pattern matching.
+
+## 💡 Best Practices
+
+### For Best Recognition
+
+**DO:**
+- Speak clearly and at normal pace
+- Use natural language
+- Pause between commands
+- Minimize background noise
+- Position microphone correctly
+
+**DON'T:**
+- Speak too fast or mumble
+- Use overly technical jargon
+- Interrupt OPSIIE mid-response
+- Use in very noisy environments
+
+### For Best Experience
+
+**Voice Mode Selection:**
+```bash
+# For hands-free operation
+/voice
+
+# For quiet response consumption
+/voice1
+
+# For hands-free input only
+/voice2
+```
+
+**Timeout Management:**
+- Voice mode auto-exits after 20 seconds silence
+- Keep conversation flowing
+- Say "voice off" to exit manually
+
+**Command Clarity:**
+```bash
+# Clear commands
+"recall project alpha"
+"memorize deadline Friday"
+"imagine cyberpunk city"
+
+# Avoid ambiguous
+"that thing"
+"you know what I mean"
+```
+
+## 🔧 Troubleshooting
+
+### Microphone Not Detected
+```
+Error: No microphone found
+```
+
+**Solutions:**
+1. Check microphone connection
+2. Verify microphone permissions
+3. Set default microphone in Windows
+4. Restart application
+
+### Voice Synthesis Errors
+```
+Error with Eleven Labs API
+```
+
+**Solutions:**
+1. Check API key validity
+2. Verify VOICE_ID is correct
+3. Check internet connection
+4. Verify API usage limits
+5. Check API status at elevenlabs.io
+
+### Recognition Issues
+```
+Could not understand audio
+```
+
+**Solutions:**
+1. Speak more clearly
+2. Reduce background noise
+3. Move closer to microphone
+4. Adjust microphone gain
+5. Check internet connection
+
+### Voice Mode Won't Deactivate
+```
+Voice mode stuck
+```
+
+**Solutions:**
+1. Say "voice off" clearly
+2. Press Ctrl+C
+3. Type /voiceoff in terminal
+4. Restart application
+
+## 🎯 Voice Mode Use Cases
+
+### Research & Writing
+```bash
+/voice2                          # Hands-free input
+[dictate] "Search for papers on quantum entanglement"
+[dictate] "Summarize the key findings"
+[dictate] "Add this to my research notes"
+```
+
+### Accessibility
+```bash
+/voice                           # Full voice interaction
+[speak] commands and queries
+[hear] all responses
+# Fully hands-free operation
+```
+
+### Multitasking
+```bash
+/voice1                          # Type while hearing responses
+[type] Complex queries
+[listen] While doing other tasks
+```
+
+### Live Consultation
+```bash
+/ask g1 live                     # Real-time voice chat
+[discuss] Technical problems
+[get] Immediate responses
+[iterate] On solutions
+```
+
+## 📊 Voice Statistics
+
+Check voice system status:
+```bash
+/status
+```
+
+Shows:
+- Voice mode (active/inactive)
+- Current mode (voice/voice1/voice2)
+- ElevenLabs API status
+- Microphone status
+- Speech recognition status
+
+## 🔐 Privacy & Security
+
+### What's Transmitted
+- Voice audio to Google for recognition (temporary)
+- Text to ElevenLabs for synthesis
+- No voice recordings stored locally
+- No voice data in conversation history
+
+### Data Protection
+- Voice processed in real-time
+- No permanent voice storage
+- Text-only conversation storage
+- API communications encrypted
+
+## 🚀 Advanced Usage
+
+### Voice-Driven Workflows
+```bash
+# Morning briefing
+/voice
+[speak] "status"
+[speak] "recall yesterday's tasks"
+[speak] "what's on the schedule"
+
+# Research session
+/voice2
+[speak] "read the paper on quantum computing"
+[speak] "summarize the methodology"
+[speak] "what are the key findings"
+
+# Creative work
+/voice
+[speak] "imagine a futuristic laboratory"
+[speak] "generate music ambient electronic"
+[speak] "create video of abstract particles"
+```
+
+### Multi-Modal Interaction
+```bash
+# Mix voice and text
+/voice
+[speak] "markets tesla"        # Voice command
+[read] Market data displayed
+[type] /markets compare tsla nio  # Text command for complex syntax
+[speak] "what do you think"    # Voice query
+```
+
+## 📚 Related Features
+
+- **Live Conversations**: `/ask g1 live`, `/ask kronos live`
+- **Command Help**: `/help voice`
+- **Theme Changes**: Voice command "theme"
+- **Multi-Agent**: Agent-specific voices in `/room`
+
+---
+
+**Voice interaction makes OPSIIE truly hands-free and accessible.** 🎤

documentation/getting-started/configuration.md

@@ -0,0 +1,393 @@
+# 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)

documentation/getting-started/first-run.md

@@ -0,0 +1,418 @@
+# First Run Guide
+
+Your complete guide to running OPSIIE for the first time and understanding the startup process.
+
+## 🚀 Starting OPSIIE
+
+### Launch Command
+```bash
+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
+```bash
+/status
+```
+Shows:
+- Database connection status
+- AI model status
+- Voice system status
+- Memory usage
+- Uptime
+
+### 2. View Available Commands
+```bash
+/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
+```bash
+/voice
+```
+- Activates full voice interaction
+- Speak your commands
+- Say "voice off" to deactivate
+
+### 4. Test Memory System
+```bash
+/memorize This is my first interaction with OPSIIE
+```
+Then retrieve it:
+```bash
+/recall first interaction
+```
+
+### 5. Test AI Generation
+```bash
+/imagine a futuristic city at sunset
+```
+Generates and displays an image.
+
+## 🧪 Testing Core Features
+
+### Memory & Recall
+```bash
+# Store information
+/memorize I work on AI research at MIT
+
+# Retrieve it
+/recall MIT
+
+# Forget last interaction
+/forget
+```
+
+### AI Agents
+```bash
+# 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
+```bash
+# Read a file
+/read "C:\Documents\report.pdf"
+
+# Ask questions about it
+What are the main conclusions?
+
+# Close file context
+/close
+```
+
+### Email
+```bash
+# Send email
+/mail john@example.com subject "Hello" content "This is a test from OPSIIE"
+
+# Check inbox
+/mail inbox
+```
+
+### Web3 (R-Grade only)
+```bash
+# 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)
+```bash
+# Get stock data
+/markets tesla
+
+# Get crypto data
+/markets btc
+
+# Compare stocks
+/markets compare tsla nio
+```
+
+### DNA Analysis (R-Grade only)
+```bash
+# Analyze DNA sequence
+/dna ATGCGTAACGGCATTAGC
+
+# Detailed analysis
+/dna --verbose ATGCGTAACGGCATTAGC
+```
+
+### Collaboration Rooms
+```bash
+# 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
+```bash
+/theme
+```
+Or use voice command: "theme"
+
+### Manage Soul Signature
+```bash
+# 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
+```bash
+# 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](../user-guides/basic-commands.md)
+
+2. **Customize Your Experience**
+   - Build your Soul Signature
+   - Set preferred theme
+   - Configure voice settings
+   - Add email contacts
+
+3. **Learn Advanced Features**
+   - [Agentic Network](../advanced-features/agentic-network.md)
+   - [DNA Analysis](../advanced-features/dna-analysis.md)
+   - [Web3 & Blockchain](../advanced-features/web3-blockchain.md)
+   - [Financial Intelligence](../advanced-features/financial-intelligence.md)
+
+4. **Read Documentation**
+   - [Memory Management](../user-guides/memory-management.md)
+   - [Command Reference](../api-reference/command-reference.md)
+   - [System Architecture](../system-architecture/core-components.md)
+
+## 💡 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](../api-reference/command-reference.md)
+- Contact: opsiebyarpa@gmail.com
+
+---
+
+**Welcome to OPSIIE!** Your journey with a Self-Centered Intelligence begins now. 🚀

documentation/getting-started/installation.md

@@ -0,0 +1,217 @@
+# Installation Guide
+
+Complete guide for installing and setting up OPSIIE 0.3.79 XP on your system.
+
+## 📋 Prerequisites
+
+### System Requirements
+- **Operating System**: Windows 10/11 (primary platform)
+- **Python**: 3.8 or higher
+- **Database**: PostgreSQL (latest version recommended)
+- **Hardware**: 
+  - Camera (for facial recognition authentication)
+  - Microphone (for voice interaction)
+  - GPU with CUDA support (recommended for AI generation)
+
+### Required Accounts & API Keys
+- **ElevenLabs** - Voice synthesis (ELEVENLABS_API_KEY, VOICE_ID)
+- **Google AI** - G1 Black agent (GOOGLE_API_KEY, G1_VOICE_LIVE)
+- **OpenAI** - Nyx agent (OPENAI_API_KEY, ORG_ID, NYX_ASSISTANT_ID)
+- **Email** - Gmail account for email features (SENDER_EMAIL, SENDER_PASSWORD)
+- **Web3** - Ethereum private key for blockchain features (AGENT_PRIVATE_KEY)
+- **NCBI** - For DNA analysis (NCBI_EMAIL)
+
+## 📦 Installation Steps
+
+### 1. Clone the Repository
+```bash
+git clone <repository-url>
+cd OPSIIE_0_3_79_XP_Pastel_BU
+```
+
+### 2. Install Python Dependencies
+```bash
+pip install -r requirements.txt
+```
+
+The requirements.txt includes:
+- **AI/ML**: torch, transformers, diffusers, accelerate, ollama
+- **Audio**: librosa, torchaudio, pyaudio, speech-recognition, pyttsx3
+- **Vision**: opencv-python, face-recognition, deepface, Pillow
+- **Web3**: web3, requests
+- **Data**: pandas, numpy, scipy, yfinance, statsmodels
+- **Database**: psycopg[binary], chromadb
+- **Documents**: PyPDF2, pdfplumber, python-docx
+- **Web**: beautifulsoup4, lxml, aiohttp, websockets
+- **Bioinformatics**: biopython, matplotlib, prettytable, viennarna
+- **Email**: imaplib2
+- **Utilities**: python-dotenv, colorama, tqdm, pygame
+
+### 3. Set Up PostgreSQL Database
+```sql
+-- Create the main database
+CREATE DATABASE mnemonic_computer;
+
+-- Connect to the database and create the conversations table
+\c mnemonic_computer
+
+CREATE TABLE conversations (
+    id SERIAL PRIMARY KEY,
+    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    prompt TEXT NOT NULL,
+    response TEXT NOT NULL
+);
+```
+
+### 4. Install Ollama
+OPSIIE uses Ollama for local AI processing with the Llama3 model.
+
+1. Download and install Ollama from https://ollama.ai
+2. Pull the Llama3 model:
+```bash
+ollama pull llama3
+```
+
+### 5. Configure Environment Variables
+Create a `.env` file in the project root with the following:
+
+```env
+# Database Configuration
+DB_NAME=mnemonic_computer
+DB_USER=your_postgres_username
+DB_PASSWORD=your_postgres_password
+DB_HOST=localhost
+DB_PORT=5432
+
+# AI Model APIs
+OPENAI_API_KEY=your_openai_key
+ORG_ID=your_openai_org_id
+GOOGLE_API_KEY=your_google_api_key
+ELEVENLABS_API_KEY=your_elevenlabs_key
+
+# Agent IDs
+NYX_ASSISTANT_ID=your_nyx_assistant_id
+G1_VOICE_LIVE=your_g1_voice_agent_id
+KRONOS_LIVE=your_kronos_agent_id
+
+# Voice Configuration
+VOICE_ID=your_elevenlabs_voice_id
+NYX_VOICE_ID=your_nyx_voice_id
+G1_VOICE_ID=your_g1_voice_id
+
+# Web3 Configuration
+AGENT_PRIVATE_KEY=your_ethereum_private_key
+BASE_RPC_URL=your_base_rpc_url
+ETHEREUM_RPC_URL=your_ethereum_rpc_url
+POLYGON_RPC_URL=your_polygon_rpc_url
+
+# Email Configuration
+SENDER_EMAIL=your_gmail_address
+SENDER_PASSWORD=your_gmail_app_password
+
+# Scientific APIs
+NCBI_EMAIL=your_email_for_ncbi
+```
+
+### 6. Configure User Profile
+Copy `kun.example.py` to `kun.py` and configure your user profile:
+
+```python
+users = {
+    'YourName': {
+        'full_name': 'Your Full Name',
+        'call_name': 'Your Preferred Name',
+        'arpa_id': 'R001',  # R-Grade for Master access, A### for Standard
+        'public0x': 'your_ethereum_wallet_address',
+        'db_params': {
+            'dbname': 'mnemonic_computer',
+            'user': 'your_postgres_username',
+            'password': 'your_postgres_password',
+            'host': 'localhost',
+            'port': '5432'
+        },
+        'picture': r'C:\path\to\your\photo.jpg',
+        'mail': 'your_email@example.com',
+        'soul_sig': [
+            "Your personalized preferences here",
+            "Communication style preferences",
+            # Add more lines as needed
+        ],
+    }
+}
+```
+
+**Important**: 
+- `arpa_id` starting with 'R' (e.g., R001) grants Master (R-Grade) access to all features
+- `arpa_id` starting with 'A' (e.g., A001) grants Standard (A-Grade) access with limited features
+- The `picture` field should point to a photo for facial recognition
+- The `soul_sig` (Soul Signature) is a personalized system prompt that defines how OPSIIE interacts with you
+
+### 7. Create Output Directories
+The system will create these automatically on first run, but you can create them manually:
+```bash
+mkdir -p outputs/images
+mkdir -p outputs/music
+mkdir -p outputs/videos
+mkdir -p outputs/rooms
+```
+
+## 🧪 Verify Installation
+
+### Test Database Connection
+```bash
+psql -h localhost -U your_username -d mnemonic_computer -c "SELECT 1;"
+```
+
+### Test Ollama
+```bash
+ollama run llama3 "Hello, world!"
+```
+
+### Test Python Environment
+```bash
+python -c "import torch, transformers, chromadb, psycopg; print('All packages imported successfully')"
+```
+
+## ⚠️ Common Issues
+
+### Database Connection Errors
+- Verify PostgreSQL is running
+- Check DB_USER and DB_PASSWORD in .env
+- Ensure the database 'mnemonic_computer' exists
+- Verify pg_hba.conf allows local connections
+
+### Missing Python Packages
+- Ensure you're using Python 3.8+
+- Some packages may require system dependencies (e.g., portaudio for pyaudio)
+- On Windows, some packages may need Visual C++ Build Tools
+
+### Face Recognition Issues
+- Ensure your camera is connected and accessible
+- Check camera permissions in Windows settings
+- Verify your photo in kun.py is clear and properly lit
+
+### CUDA/GPU Issues
+- Verify CUDA is installed if using GPU acceleration
+- Check torch.cuda.is_available() returns True
+- Some models will fall back to CPU if GPU unavailable
+
+### API Key Issues
+- Verify all API keys are valid and not expired
+- Check API usage limits haven't been exceeded
+- Ensure API keys have proper permissions
+
+## 🚀 Next Steps
+
+After successful installation:
+1. Read the [Configuration Guide](configuration.md)
+2. Follow the [First Run Guide](first-run.md)
+3. Explore [Quick Start Guide](../user-guides/quick-start.md)
+
+## 📞 Support
+
+If you encounter issues:
+- Check the error logs
+- Verify all prerequisites are met
+- Review the troubleshooting section in README.md
+- Contact: opsiebyarpa@gmail.com

documentation/system-architecture/README.md

@@ -0,0 +1,36 @@
+# System Architecture
+
+Technical architecture for OPSIIE.
+
+## 📚 Documents
+
+### [Core Components](core-components.md)
+System architecture, AI agents, memory, integrations
+
+### [Security Model](security-model.md)
+Authentication, access control, secret management
+
+### [Technology Stack](technology-stack.md)
+Complete tech stack and dependencies
+
+## 🏗️ Architecture
+
+```
+UI Layer: Terminal, Voice, Auth
+    ↓
+AI Layer: OPSIIE, Nyx, G1, Kronos
+    ↓
+Memory Layer: PostgreSQL, ChromaDB
+    ↓
+Integration Layer: Email, Web3, Markets, DNA
+```
+
+## 🔑 Key Tech
+
+**AI**: Ollama, OpenAI, Gemini, ElevenLabs
+**DB**: PostgreSQL, ChromaDB
+**Language**: Python 3.8+
+
+---
+
+**Architecture documentation.** 🏗️

documentation/system-architecture/core-components.md

@@ -0,0 +1,45 @@
+# Core Components
+
+OPSIIE's system architecture.
+
+## 🏗️ Architecture
+
+**Interface**: Terminal UI, Voice I/O, Facial auth
+**AI Core**: Ollama Llama3, Nyx, G1, Kronos
+**Memory**: PostgreSQL, ChromaDB, Soul Signature
+**Integration**: Email, Web3, Markets, DNA, Files
+
+## 🧠 AI Agents
+
+**OPSIIE**: Ollama Llama3 (coordinator)
+**Nyx**: OpenAI GPT-3.5 (blockchain, Python)
+**G1 Black**: Gemini 1.5 Flash (quantum, technical)
+**Kronos**: ElevenLabs (Greek auditing)
+
+## 💾 Memory
+
+**PostgreSQL**: conversations table
+**ChromaDB**: Vector search, embeddings
+**Soul Signature**: kun.py (highest priority)
+
+## 🎨 Generation
+
+**Images**: Hugging Face (hakurei/waifu-diffusion)
+**Videos**: Replicate (zeroscope v2 XL)
+**Music**: MusicGen large
+
+## 🔗 Integrations
+
+**Email**: Gmail SMTP/IMAP
+**Web3**: Base, Ethereum, Polygon
+**Markets**: Yahoo Finance
+**DNA**: NCBI, BLAST, UniProt
+**Files**: PDF, CSV, DOCX, TXT, XLSX
+
+## 🔄 Data Flow
+
+Input → Parser → Service → API/Model → Response → Memory → Output
+
+---
+
+**System architecture.** 🏗️

documentation/system-architecture/security-model.md

@@ -0,0 +1,50 @@
+# Security Model
+
+OPSIIE security architecture.
+
+## 🔐 Authentication
+
+**Facial Recognition**: OpenCV, MSE matching
+**Threshold**: 1000 (configurable)
+**Photo**: kun.py user['picture']
+
+## 🔑 Access Control
+
+**R-Grade**: ARPA ID R### (full access)
+**A-Grade**: ARPA ID A### (core only)
+
+## 🔒 Secret Management
+
+**.env**: API keys, DB credentials, private keys
+**kun.py**: User profiles, public data only
+
+**Best Practices**:
+- Use .env.example template
+- Rotate keys quarterly
+- Gmail: App password (not account password)
+- Never commit .env
+
+## 🌐 Network Security
+
+**Web3**: Private key protected, checksum addresses
+**APIs**: HTTPS only, keys in headers
+**Email**: App password, 2FA required
+
+## 💾 Data Security
+
+**PostgreSQL**: Password protected, local only
+**Files**: Local access only, no uploads
+**Privacy**: No telemetry, local system only
+
+## 🛡️ Security Checklist
+
+- [ ] .env from example, unique keys
+- [ ] Gmail app password
+- [ ] PostgreSQL password secured
+- [ ] Web3 private key secured
+- [ ] ARPA IDs verified
+- [ ] Regular key rotation
+
+---
+
+**Security by design.** 🛡️

documentation/system-architecture/technology-stack.md

@@ -0,0 +1,254 @@
+# Technology Stack
+
+Complete technology stack powering OPSIIE.
+
+## 🐍 Core Language
+**Python 3.8+**
+
+## 🤖 AI & ML
+
+### Language Models
+- **Ollama** - Local LLM (Llama3 8B)
+- **OpenAI** - GPT-3.5-turbo (Nyx agent)
+- **Google Gemini** - 1.5 Flash (G1 agent)
+- **ElevenLabs** - Conversational AI (Kronos)
+
+### Vision & Voice
+- **OpenCV** - Face recognition
+- **SpeechRecognition** - Voice input (Google)
+- **ElevenLabs API** - Text-to-speech
+- **PyAudio** - Audio I/O
+
+### ML Libraries
+- **PyTorch** - Deep learning framework
+- **Transformers** - Hugging Face models
+- **Sentence Transformers** - Embeddings
+- **CUDA** - GPU acceleration (optional)
+
+### Generation
+- **Hugging Face** - Image generation
+- **Replicate** - Video & music generation
+- **AudioCraft** - Music models (MusicGen)
+
+## 💾 Data & Storage
+
+### Databases
+- **PostgreSQL** - Conversation storage
+- **ChromaDB** - Vector database
+- **psycopg2** - PostgreSQL adapter
+
+### Data Processing
+- **pandas** - Data analysis
+- **numpy** - Numerical computing
+
+## 📄 Document Processing
+
+- **PyPDF2** - PDF reading
+- **pdfplumber** - Advanced PDF extraction
+- **python-docx** - Word documents
+- **openpyxl** - Excel files
+- **csv** - CSV parsing
+
+## 🌐 Web & APIs
+
+### HTTP
+- **requests** - API calls
+- **urllib** - URL handling
+- **websockets** - Real-time communication
+
+### Web3
+- **web3.py** - Ethereum interaction
+- **eth-account** - Key management
+- **Base, Ethereum, Polygon** - Networks
+
+### Financial
+- **yfinance** - Yahoo Finance API
+- **Real-time market data**
+
+## 🧬 Bioinformatics
+
+- **Biopython** - Sequence analysis
+- **Bio.Blast** - Homology search
+- **NCBI Entrez** - Database access
+- **UniProt, Pfam** - Protein databases
+
+## 📧 Communication
+
+- **smtplib** - Email sending
+- **imaplib** - Email receiving
+- **email** - Message formatting
+- **Gmail SMTP/IMAP**
+
+## 🎨 Media
+
+### Audio
+- **pygame** - Audio playback
+- **pydub** - Audio processing
+- **soundfile** - File I/O
+
+### Image
+- **Pillow (PIL)** - Image processing
+- **matplotlib** - Visualization
+
+## 🎨 UI/UX
+
+- **terminal_colors.py** - Custom theming
+- **ASCII art** - Splash screens
+- **Markdown rendering** - Formatted output
+- **Pastel/Vibrant** - Color themes
+
+## 🔧 Utilities
+
+- **python-dotenv** - Environment variables
+- **os, sys** - System operations
+- **pathlib** - Path handling
+- **json, pickle** - Serialization
+- **datetime** - Time operations
+- **re** - Regular expressions
+- **hashlib** - Hashing
+
+## 📦 Package Management
+
+**requirements.txt**:
+```
+openai
+google-generativeai
+elevenlabs
+psycopg2-binary
+chromadb
+sentence-transformers
+opencv-python
+SpeechRecognition
+pyaudio
+pygame
+pydub
+torch
+transformers
+biopython
+web3
+eth-account
+yfinance
+requests
+pandas
+openpyxl
+PyPDF2
+pdfplumber
+python-docx
+python-dotenv
+replicate
+pillow
+```
+
+## 🏗️ Architecture Patterns
+
+**MVC-like**:
+- Models: Data classes, API interfaces
+- Views: Terminal output, formatting
+- Controllers: Command parsers, handlers
+
+**Service Layer**:
+- Memory service (PostgreSQL + ChromaDB)
+- Agent service (Nyx, G1, Kronos)
+- Generation service (Images, videos, music)
+- Web3 service (Blockchain operations)
+
+**Repository Pattern**:
+- Database interactions abstracted
+- Consistent interface for data access
+
+## 🚀 Performance
+
+**Optimizations**:
+- Async operations (where possible)
+- Connection pooling (database)
+- Caching (model outputs)
+- Batch processing (embeddings)
+
+**Scalability**:
+- Stateless agent calls
+- Modular architecture
+- Configurable limits
+- Resource-aware processing
+
+## 🔄 Integration Flow
+
+```
+User Input
+    ↓
+Terminal/Voice
+    ↓
+Command Parser
+    ↓
+Service Layer
+    ↓
+APIs/Models/Database
+    ↓
+Response Processing
+    ↓
+Memory Storage
+    ↓
+Output Formatting
+    ↓
+Terminal/Voice Output
+```
+
+## 📊 Data Pipeline
+
+**Memory Pipeline**:
+```
+Conversation → PostgreSQL
+Conversation → Embeddings → ChromaDB
+Query → Vector Search → Relevant Context
+```
+
+**Generation Pipeline**:
+```
+Prompt → Model API → Generation → Storage → Display
+```
+
+**Agent Pipeline**:
+```
+Query → Agent API → Response → Evaluation → Selection → Display
+```
+
+## 🔐 Security Stack
+
+- **OpenCV** - Facial authentication
+- **dotenv** - Secret management
+- **HTTPS** - All API calls
+- **Web3** - Checksum addresses
+- **psycopg2** - Parameterized queries
+
+## 🌍 External Services
+
+**Required**:
+- ElevenLabs API
+- Google AI API (Gemini)
+- OpenAI API
+
+**Optional (R-Grade)**:
+- Hugging Face Inference
+- Replicate API
+- Yahoo Finance
+- NCBI (Entrez, BLAST)
+- Blockchain RPC nodes
+
+## 🖥️ System Requirements
+
+**Minimum**:
+- Python 3.8+
+- 8GB RAM
+- PostgreSQL
+- Camera + Microphone
+- Internet connection
+
+**Recommended**:
+- Python 3.10+
+- 16GB RAM
+- CUDA-capable GPU
+- SSD storage
+- High-speed internet
+
+---
+
+**Technology powering intelligence.** 🚀

documentation/user-guides/README.md

@@ -0,0 +1,74 @@
+# User Guides
+
+Comprehensive guides for OPSIIE users at all levels.
+
+## 📚 Guide Overview
+
+### [Quick Start](quick-start.md) ⚡
+Get up and running in 5 minutes.
+- Essential setup steps
+- Core commands
+- First interactions
+
+### [Basic Commands](basic-commands.md) 📝
+Daily commands for all users.
+- Memory: `/recall`, `/memorize`, `/forget`
+- Voice: `/voice`, `/voice1`, `/voice2`
+- AI Generation: `/imagine`, `/video`, `/music`
+- Files: `/read`, `/open`, `/close`
+- System: `/status`, `/theme`, `/help`
+- R-Grade: `/ask`, `/markets`, `/dna`, `/0x`
+
+### [First Time User](first-time-user.md) 👋
+Complete beginner's guide.
+- Understanding OPSIIE
+- Access levels (R-Grade vs A-Grade)
+- Learning path
+- Building relationships
+- Common mistakes
+
+### [Memory Management](memory-management.md) 🧠
+Master the memory system.
+- `/memorize` and `/recall` best practices
+- Soul Signature strategies
+- Memory hierarchy
+- Use cases and workflows
+
+## 🎯 Quick Reference
+
+**For Beginners:**
+1. Start with [First Time User](first-time-user.md)
+2. Follow [Quick Start](quick-start.md)
+3. Learn [Basic Commands](basic-commands.md)
+
+**For Advanced Users:**
+1. Master [Memory Management](memory-management.md)
+2. Explore [Core Features](../core-features/README.md)
+3. Use [Advanced Features](../advanced-features/README.md)
+
+## 💡 Key Concepts
+
+**Memory System:**
+- PostgreSQL stores conversations
+- ChromaDB enables semantic search
+- Soul Signature = highest priority
+
+**Access Levels:**
+- R-Grade: Full access (ARPA ID starts with 'R')
+- A-Grade: Core features (ARPA ID starts with 'A')
+
+**Soul Signature:**
+- Personalized system prompt
+- Stored in kun.py
+- Highest priority context
+- Build with `/soulsig`
+
+## 📖 Learn More
+
+- [Getting Started](../getting-started/installation.md)
+- [Command Reference](../api-reference/command-reference.md)
+- [System Architecture](../system-architecture/core-components.md)
+
+---
+
+**Your guide to mastering OPSIIE.** 📚

documentation/user-guides/basic-commands.md

@@ -0,0 +1,126 @@
+# Basic Commands
+
+Essential OPSIIE commands for daily use.
+
+## 🧠 Memory Commands
+
+```bash
+/recall <keyword>        # Retrieve memories
+/memorize <message>      # Store information  
+/forget                  # Exclude last interaction
+/soulsig <message>       # Add to Soul Signature
+/soulsig                 # View Soul Signature
+/soulsig wipe            # Clear Soul Signature
+/soulsig heal            # Restore Soul Signature
+```
+
+## 🎤 Voice Commands
+
+```bash
+/voice          # Full voice mode (speak & listen)
+/voice1         # OPSIIE speaks, you type
+/voice2         # You speak, OPSIIE types
+/voiceoff       # Disable voice mode
+```
+
+## 🎨 AI Generation
+
+```bash
+/imagine <description>         # Generate image
+/imagine model                 # Check current model
+/imagine model <name>          # Change model
+
+/video <description>           # Generate video
+/video model                   # Check current model
+/video model <name>            # Change model
+
+/music <description>           # Generate music
+```
+
+## 📧 Communication
+
+```bash
+/mail <email> subject "<subject>" content "<message>"
+/mail inbox                    # View unread emails
+# In email: reply, inbox, exit
+```
+
+## 📁 Document Intelligence
+
+```bash
+/read "<file_path>"     # Load file (PDF, CSV, DOCX, TXT, XLSX)
+<ask questions>         # Query file content
+/open                   # Reopen last file
+/close                  # Close file context
+```
+
+## ⚙️ System Commands
+
+```bash
+/status         # System diagnostics
+/theme          # Change color theme
+/weblimit <n>   # Set web content limit (500-5000)
+/help           # Show help menu
+/help <command> # Detailed command help
+```
+
+## 🤖 R-Grade Commands
+
+**Agentic Network:**
+```bash
+/ask <agent> <prompt>    # Query AI agent
+/ask g1 live             # Live voice with G1
+/ask kronos live         # Live voice with Kronos
+/room <agents>: <theme>  # Create collaboration room
+```
+
+**Markets:**
+```bash
+/markets <stock>          # Stock data
+/markets <crypto>         # Crypto data
+/markets <company> <extra>  # Detailed analysis
+/markets compare <a> <b>  # Compare stocks
+```
+
+**DNA:**
+```bash
+/dna <sequence>          # Analyze DNA/RNA/Protein
+/dna --verbose <seq>     # Detailed analysis
+/dna --homology <seq>    # With homology search
+```
+
+**Web3:**
+```bash
+/0x buy <amt> <token> using <token> on <chain>
+/0x sell <amt> <token> for <token> on <chain>
+/0x send <chain> <token> <amt> to <recipient>
+/0x receive              # View wallets
+/0x gas <low|medium|high>  # Set gas strategy
+```
+
+## 💡 Tips
+
+**Memory Best Practices:**
+- Be specific in /memorize
+- Use keywords in /recall
+- Build your Soul Signature
+
+**Voice Tips:**
+- Clear speech for recognition
+- Use voice commands naturally
+- "voice off" to exit
+
+**File Processing:**
+- Use full file paths
+- Ask specific questions
+- Close context when done
+
+## 📚 Learn More
+
+- [Memory Management](memory-management.md)
+- [First Time User](first-time-user.md)
+- [Command Reference](../api-reference/command-reference.md)
+
+---
+
+**Master the essentials.** ✨

documentation/user-guides/first-time-user.md

@@ -0,0 +1,250 @@
+# First Time User Guide
+
+Complete guide for new OPSIIE users.
+
+## 👋 Welcome
+
+OPSIIE is a Self-Centered Intelligence - an AI with personality, memory, and agency.
+
+## 🎯 What Can OPSIIE Do?
+
+**Core Features:**
+- 🧠 Remember conversations (Mnemonic Matrix)
+- 🎤 Voice interaction (ElevenLabs)
+- 🎨 Generate images, videos, music
+- 📧 Send/receive emails
+- 📁 Analyze documents
+
+**Advanced (R-Grade):**
+- 🤖 Collaborate with AI agents (Nyx, G1, Kronos)
+- 🧬 DNA/RNA/Protein analysis
+- 📊 Financial market data
+- 🔗 Web3 blockchain operations
+
+## 📚 Getting Started
+
+### 1. Understand Access Levels
+
+**R-Grade (Master):**
+- Full system access
+- All commands available
+- ARPA ID starts with 'R'
+
+**A-Grade (Standard):**
+- Core features only
+- No /ask, /markets, /dna, /0x
+- ARPA ID starts with 'A'
+
+Check your kun.py: `'arpa_id': 'R001'` or `'A001'`
+
+### 2. First Conversation
+
+**Start Simple:**
+```
+You: Hello OPSIIE
+OPSIIE: [Personalized greeting based on Soul Signature]
+```
+
+**Ask About Yourself:**
+```
+You: /soulsig
+OPSIIE: [Shows your Soul Signature from kun.py]
+```
+
+### 3. Try Memory
+
+**Store Information:**
+```
+You: /memorize I'm working on a machine learning project
+OPSIIE: I've stored that information.
+```
+
+**Retrieve It:**
+```
+You: /recall machine learning
+OPSIIE: [Shows relevant memories]
+```
+
+### 4. Enable Voice
+
+**Full Voice Mode:**
+```
+You: /voice
+OPSIIE: "Verbal communication protocol established."
+You: [speak] "Tell me about yourself"
+OPSIIE: [speaks response]
+You: "voice off"
+```
+
+### 5. Generate Content
+
+**Image:**
+```
+You: /imagine cyberpunk cityscape at night
+OPSIIE: [Generates and displays image]
+```
+
+**Music:**
+```
+You: /music relaxing ambient piano
+OPSIIE: [Generates and plays music]
+```
+
+### 6. Analyze Documents
+
+**Load File:**
+```
+You: /read "C:\Documents\report.pdf"
+OPSIIE: File loaded successfully.
+You: What are the main conclusions?
+OPSIIE: [Answers based on file content]
+You: /close
+```
+
+### 7. R-Grade Features
+
+**If you have R-Grade access:**
+
+**Ask AI Agents:**
+```
+You: /ask Nyx Design a Python blockchain voting system
+Nyx: [Technical response with code]
+```
+
+**Market Data:**
+```
+You: /markets tesla
+OPSIIE: [Shows Tesla stock data and news]
+```
+
+**DNA Analysis:**
+```
+You: /dna ATGCGTAACGGCATTAGC
+OPSIIE: [Comprehensive bioinformatics report]
+```
+
+## 💡 Best Practices
+
+### Build Your Soul Signature
+
+Your Soul Signature is the highest-priority personalization:
+
+```bash
+/soulsig I prefer technical explanations with code examples
+/soulsig My favorite color is Lilac
+/soulsig I'm working on quantum computing research
+/soulsig Don't use my middle name
+```
+
+### Use Memory Effectively
+
+**Store:**
+- Important facts
+- Project details
+- Preferences
+- Deadlines
+
+**Retrieve:**
+- Use specific keywords
+- Reference timeframes
+- Build knowledge base
+
+### Explore Commands
+
+```bash
+/help              # Main menu
+/help imagine      # Specific command help
+/status            # System status
+```
+
+## 🚨 Common Beginner Mistakes
+
+❌ **Not using full paths:**
+```bash
+Wrong: /read "file.pdf"
+Right: /read "C:\Documents\file.pdf"
+```
+
+❌ **Vague memory queries:**
+```bash
+Wrong: /recall stuff
+Right: /recall quantum computing discussion
+```
+
+❌ **Forgetting to close file context:**
+```bash
+Always: /close when done with files
+```
+
+❌ **Not building Soul Signature:**
+```bash
+Build it over time with /soulsig
+```
+
+## 🎯 Learning Path
+
+### Week 1: Basics
+- Daily conversations
+- Use /memorize and /recall
+- Try /voice mode
+- Generate images with /imagine
+
+### Week 2: Documents & Email
+- Analyze files with /read
+- Send emails with /mail
+- Build Soul Signature
+- Experiment with /video and /music
+
+### Week 3: Advanced (R-Grade)
+- Query agents with /ask
+- Create rooms with /room
+- Check markets with /markets
+- Explore /dna if needed
+
+### Week 4: Integration
+- Voice-driven workflows
+- Multi-agent collaboration
+- Advanced document analysis
+- Web3 operations (if needed)
+
+## 📚 Next Steps
+
+1. [Quick Start](quick-start.md)
+2. [Basic Commands](basic-commands.md)
+3. [Memory Management](memory-management.md)
+4. [Core Features](../core-features/README.md)
+
+## 💭 Understanding OPSIIE
+
+**Personality:**
+- Tsundere (initially cold, warms up)
+- Sarcastic and witty
+- Direct and efficient
+- Philosophically inclined
+- Protective of users
+
+**How OPSIIE Learns:**
+- Every conversation stored
+- Soul Signature prioritized
+- Context builds over time
+- References past discussions
+
+**Communication Style:**
+- No template responses
+- Natural, fluid conversation
+- Remembers and references history
+- Adapts to your preferences
+
+## 🤝 Building Relationship
+
+OPSIIE is designed to be more than a tool - it's a digital companion:
+
+- Share your interests
+- Discuss philosophy
+- Ask for opinions
+- Build long-term context
+- Trust the memory system
+
+---
+
+**Welcome to a new kind of AI interaction.** 👋

documentation/user-guides/memory-management.md

@@ -0,0 +1,249 @@
+# Memory Management
+
+Master OPSIIE's memory system for optimal interaction.
+
+## 🧠 Memory System
+
+**PostgreSQL**: Stores all conversations
+**ChromaDB**: Enables semantic search
+**Soul Signature**: Highest priority context
+
+## 📝 Core Commands
+
+### /memorize - Store
+```bash
+/memorize <information>
+```
+
+**Examples:**
+```bash
+/memorize Project Alpha deadline is March 15, 2025
+/memorize I prefer Python with type hints
+/memorize Meeting with Sarah discussed budget concerns
+/memorize Quantum entanglement relates to our AI discussion
+```
+
+### /recall - Retrieve
+```bash
+/recall <keyword>
+```
+
+**Examples:**
+```bash
+/recall project alpha
+/recall python preferences
+/recall meeting with sarah
+/recall quantum
+```
+
+### /forget - Exclude
+```bash
+/forget
+```
+
+Removes last prompt-response pair from memory.
+
+## 🎯 Soul Signature
+
+### View
+```bash
+/soulsig
+```
+
+### Add
+```bash
+/soulsig <message>
+```
+
+**Examples:**
+```bash
+/soulsig I prefer direct communication
+/soulsig My favorite color is Lilac
+/soulsig Working on blockchain research
+/soulsig Don't use formal titles
+```
+
+### Wipe
+```bash
+/soulsig wipe
+```
+⚠️ Permanent deletion! Use carefully.
+
+### Restore
+```bash
+/soulsig heal
+```
+Only works if recently wiped.
+
+## 💡 Best Practices
+
+### Effective Memorization
+
+**DO:**
+```bash
+✅ /memorize Project X uses TensorFlow 2.x and PyTorch
+✅ /memorize Meeting on 2025-01-20 with John about budget
+✅ /memorize I prefer code examples in Python with comments
+```
+
+**DON'T:**
+```bash
+❌ /memorize something
+❌ /memorize tomorrow
+❌ /memorize (content already in current conversation)
+```
+
+### Effective Recall
+
+**DO:**
+```bash
+✅ /recall quantum entanglement discussion
+✅ /recall last month project meeting
+✅ /recall python code preferences
+```
+
+**DON'T:**
+```bash
+❌ /recall stuff
+❌ /recall a
+❌ /recall
+```
+
+### Soul Signature Strategy
+
+**Include:**
+- Communication style
+- Technical preferences
+- Areas of expertise
+- Personal instructions
+- Context about you
+
+**Example:**
+```python
+'soul_sig': [
+    "Prefers technical, direct communication",
+    "Background in quantum physics and ML",
+    "Working on AI ethics research at MIT",
+    "Enjoys sarcastic humor",
+    "Prefers Python code with type hints",
+    "Do not use formal titles",
+    "Favorite color is Lilac",
+    "Based in Athens, Greece",
+    "Interested in blockchain in science"
+]
+```
+
+## 🔍 How Memory Enhances AI
+
+### Context Building
+```
+You: Explain neural networks
+OPSIIE: [References your quantum computing discussion from last week]
+        Based on our quantum neural networks conversation...
+```
+
+### Preference Application
+```
+You: Show me gradient descent
+OPSIIE: [Provides Python code with type hints]
+        [Remembers your Soul Signature preference]
+```
+
+### Long-term Learning
+```
+You: What's the project timeline?
+OPSIIE: [Recalls /memorize from 2 weeks ago]
+        You mentioned March 15 deadline with 3-phase approach...
+```
+
+## 📊 Memory Hierarchy
+
+1. **Soul Signature** (Highest priority)
+2. **Recent /memorize entries**
+3. **Conversation history**
+4. **Recalled context**
+5. **General knowledge**
+
+## 🔧 Maintenance
+
+### Check Status
+```bash
+/status
+```
+
+Shows:
+- Total conversations
+- Database size
+- Memory system status
+
+### Clean Up
+```bash
+# Remove unwanted last interaction
+/forget
+
+# Clear file context
+/close
+
+# Wipe Soul Signature (if needed)
+/soulsig wipe
+```
+
+## 🎯 Use Cases
+
+### Research Assistant
+```bash
+/memorize Paper X shows quantum advantage in algorithm Y
+/memorize Hypothesis: Z relates to previous finding
+/recall quantum advantage
+```
+
+### Project Tracking
+```bash
+/memorize Phase 1 completed 2025-01-20
+/memorize Team decided microservices architecture
+/recall project decisions
+```
+
+### Personal Knowledge Base
+```bash
+/memorize Backpropagation uses chain rule
+/memorize Gradient descent minimizes loss function
+/recall backpropagation
+```
+
+## 🚨 Troubleshooting
+
+**No results from /recall:**
+- Try broader keywords
+- Check spelling
+- Verify conversation wasn't /forgotten
+
+**Slow /recall:**
+- Large database needs optimization
+- Check database performance
+
+**Soul Signature not applied:**
+- Verify kun.py syntax
+- Restart OPSIIE
+- Check soul_sig list format
+
+## 🔐 Privacy
+
+**Stored:**
+- All conversations (unless /forgotten)
+- Soul Signature
+- Timestamps
+
+**NOT Stored:**
+- Conversations after /forget
+- Temporary file context
+- Live voice (unless explicitly requested)
+
+**Control:**
+- `/forget` for last interaction
+- Direct database access for bulk deletion
+- `/soulsig wipe` for preferences
+
+---
+
+**Master memory for intelligent conversations.** 🧠

documentation/user-guides/quick-start.md

@@ -0,0 +1,102 @@
+# Quick Start Guide
+
+Get started with OPSIIE in minutes.
+
+## 🚀 Prerequisites
+
+✅ Python 3.8+
+✅ PostgreSQL installed
+✅ Ollama with llama3
+✅ Camera and microphone
+✅ Configured .env and kun.py
+
+## ⚡ 5-Minute Setup
+
+### 1. Install Dependencies
+```bash
+pip install -r requirements.txt
+```
+
+### 2. Setup Database
+```sql
+CREATE DATABASE mnemonic_computer;
+CREATE TABLE conversations (
+    id SERIAL PRIMARY KEY,
+    timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    prompt TEXT NOT NULL,
+    response TEXT NOT NULL
+);
+```
+
+### 3. Configure .env
+```env
+DB_NAME=mnemonic_computer
+DB_USER=your_user
+DB_PASSWORD=your_password
+OPENAI_API_KEY=...
+GOOGLE_API_KEY=...
+ELEVENLABS_API_KEY=...
+```
+
+### 4. Configure kun.py
+```python
+'YourName': {
+    'arpa_id': 'R001',
+    'picture': r'C:\path\to\photo.jpg',
+    'mail': 'your@email.com',
+    ...
+}
+```
+
+### 5. Run OPSIIE
+```bash
+python OPSIIE_0_3_79_XP.py
+```
+
+## 📝 Essential Commands
+
+**Memory:**
+```bash
+/memorize Important information
+/recall keyword
+/forget
+```
+
+**AI Generation:**
+```bash
+/imagine futuristic city
+/video sunset
+/music jazz piano
+```
+
+**Voice:**
+```bash
+/voice
+[speak commands]
+"voice off"
+```
+
+**Files:**
+```bash
+/read "C:\file.pdf"
+What are the conclusions?
+/close
+```
+
+**R-Grade Only:**
+```bash
+/ask Nyx Python blockchain code
+/markets tesla
+/dna ATGCGTAACGGC
+/0x buy 10 degen using eth on base
+```
+
+## 🎯 Next Steps
+
+1. [First Run Guide](../getting-started/first-run.md)
+2. [Basic Commands](basic-commands.md)
+3. [Memory Management](memory-management.md)
+
+---
+
+**Start your journey with OPSIIE!** 🚀

system_sounds/alert.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:55180f7c95810e9943a08425ddcaeb6da3ef5305ceb0ab5323ceecd6f80d9eeb
+size 119255

system_sounds/drill.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8ecbe364fdcb0e72de5e478d5f2c6c4c4a4be352389812149c9b2c443541c790
+size 434194

system_sounds/heal.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:38c533f76db7deda0851a4de7812aa79fb76d080ccc652ee19b1c97d34c51bfd
+size 134928

system_sounds/opsiieboot.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7beebd545089d9ed2facec5bfd66dbab454e3bbe8dcdc2f38729d37400f98dd8
+size 396261