# Setting Up VIKI (v7.3.0 Sovereign)

## 📦 Prerequisites

1.  **Python 3.11+**: Ensure you have Python installed and added to PATH.
2.  **Ollama**: Install from [ollama.ai](https://ollama.ai) and pull the core models:
    ```bash
    ollama pull phi3
    ollama pull deepseek-r1
    ```
3.  **Visual Studio Build Tools** (Windows Only): Required for compiling `unsloth` dependencies if you plan to use `forge` for LoRA training.

## 🛠️ Environment Configuration

1.  **Clone the Repository**:
    ```powershell
    git clone https://github.com/yourusername/viki.git
    cd viki
    ```

2.  **Create Virtual Environment**:
    ```powershell
    python -m venv .venv
    ./.venv/Scripts/Activate.ps1
    ```

3.  **Install Dependencies**:
    ```powershell
    pip install -r requirements.txt
    ```

4.  **Set Up Environment Variables**:
    Create a `.env` file in the root directory (or set in your shell):
    ```env
    # Required for API server: all endpoints require this key
    VIKI_API_KEY=your_api_key_here

    # Required for super-admin / admin commands
    VIKI_ADMIN_SECRET=your_admin_secret_here

    # Optional: For high-intelligence reasoning fallbacks
    OPENAI_API_KEY=your_key_here

    # Optional: For Nexus Connectivity
    DISCORD_TOKEN=your_discord_token
    TELEGRAM_TOKEN=your_telegram_token
    ```
    **Security**: Generate strong values; never commit them. See [viki/SECURITY_SETUP.md](viki/SECURITY_SETUP.md) for details.

## 🚀 Running VIKI

To start the **Sovereign Intelligence Core** (CLI):

```powershell
python viki/main.py
```

VIKI will initialize her **Nexus** and begin listening on all channels.

### Running with the Hologram Face UI

To show the **hologram face** and **talk to VIKI** with voice:

1. In one terminal, start the React UI: `cd ui && npm run dev`
2. In another terminal, run: `python viki/main.py --ui`

The `--ui` flag starts the API server and opens your browser to `http://localhost:5173`. The default view is the **Hologram** (voice conversation); switch to **Full dashboard** for text chat. The UI needs the API key: create `ui/.env` with `VITE_VIKI_API_KEY=<same value as VIKI_API_KEY>` so the dashboard and hologram view can authenticate. See [viki/SECURITY_SETUP.md](viki/SECURITY_SETUP.md).

## 🧪 Testing

To verify key systems:

1.  **Status Check**: Type `/status` in the terminal.
2.  **Memory Recall**: Ask "What do you remember about our last session?"
3.  **Visual Test**: Ask "What's on my screen right now?"
4.  **Evolution Test**: Type `/evolve` to trigger a dry run of the Neural Forge.

---
**Enjoy your new digital partner.**