Frontend

.env.example

@@ -2,4 +2,4 @@
 # Copy this file to .env and insert your actual API keys.
 
 GROQ_API_KEY=your_groq_api_key_here
-GROQ_MODEL=llama-3.3-70b-versatile
+GROQ_MODEL=qwen/qwen3.8-27b

.gitignore

@@ -1,52 +1,49 @@
-# Python
+# Python & Environments
 __pycache__/
 *.py[cod]
+*$py.class
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
 .venv/
 venv/
+env/
+.conda/
 
-# Environment & Config (IMPORTANT)
+# Environment & Secret Files (IMPORTANT)
 .env
+.env.local
+*.env
 config.ini
 
-# Local data and generated artifacts
-cognios_telemetry.db
+# SQLite Databases & WAL/SHM artifacts
 *.db
 *.db-shm
 *.db-wal
-data/models/*.pt
-data/traces/*
+*.sqlite
+*.sqlite3
+cognios_telemetry.db*
+focusos_telemetry.db*
+alerts.db*
+blackbox.db*
 blackbox/blackbox.db-shm
 blackbox/blackbox.db-wal
 
-# Keep data directories present in git if marker files are added.
+# Local data and generated artifacts
+data/cognios.db
+data/models/*.pt
+data/traces/*
 !data/traces/.gitkeep
+!data/models/.gitkeep
+
+# Logs
+logs/
+*.log
+telemetry_daemon.log
+dashboard.log
 
 # OS / IDE
 .DS_Store
 .vscode/
 .idea/
 
-# Ignore SQLite database files
-*.db
-*.sqlite3
-*.sqlite
-
-# Logs
-logs/
-
-# Environment and secret files
-.env
-.env.local 
-*.env 
-
-.DS_Store
-*.db-shm
-*.db-wal
-# -shm, -wal files
-cognios_telemetry.db-shm
-cognios_telemetry.db-wal
-blackbox.db-shm
-blackbox.db-wal

README.md

@@ -243,19 +243,42 @@ git clone https://github.com/<your-org>/CogniOS.git
 cd CogniOS
 ```
 
-## Install Dependencies
+## Quick Start (Recommended)
 
+Run the automated launcher (creates `.venv`, installs dependencies if missing, and launches both the telemetry daemon and Streamlit dashboard):
+
+**Linux / macOS:**
 ```bash
-pip install -r requirements.txt
+./start.sh
+```
+
+**Windows:**
+```cmd
+start.bat
+```
+
+Or run directly with Python (auto-detects and uses `.venv`):
+```bash
+python main.py
 ```
 
-## Launch CogniOS
+## Manual Setup (Optional)
+
+If you prefer to configure your environment manually:
 
 ```bash
+# 1. Create and activate a virtual environment
+python3 -m venv .venv
+source .venv/bin/activate    # On Windows: .venv\Scripts\activate
+
+# 2. Install dependencies
+pip install -r requirements.txt
+
+# 3. Launch CogniOS
 python main.py
 ```
 
-To run CogniOS as a background service:
+To run only the telemetry collector daemon as a background service:
 
 ```bash
 python cognios_as_daemon.py