## Dynamic Environment Compliance

AgentOS is specifically designed to function within highly secure local workspace limits, utilizing 100% compliant scripting protocols.

Compliance Control | Implementation Detail
--- | ---
CLM Compliant | Operates flawlessly under PowerShell Constrained Language Mode by avoiding unapproved .NET classes, instead leveraging native cmdlets and clean direct process execution.
Local Security | No local HTTP/TCP network listeners are hosted. The visual agent interfaces run securely on the local file origin system via Edge/Chrome sandboxes.
Encoding Standards | All configuration, state, and script files are hard-coded to Strict UTF-8 without BOM to ensure clean terminal parsing and prevent API serialization drops.

## Step 1: Obtaining Your GenAI API Key

AgentOS requires access to a compliant secure LLM API endpoint. Follow these steps to obtain and establish your authorized connection credentials:

Step | Portal Action | Verification Instructions
--- | --- | ---
1 | Navigate to the secure MilCloud/GenAI Gateway Portal via your web browser. | Ensure you are on the authenticated, authorized network segment.
2 | Log in with your CAC/SmartCard certificate and go to the Developer API Keys section. | Request a new developer key if you do not have one actively registered.
3 | Copy the generated key string (e.g., `sk-genai-...`). | Warning: Treat this key as a sensitive credential. Never share, email, or commit this raw key.
4 | Run the automated setup wizard (detailed in Step 2) to link the key safely. | The setup wizard will write this key directly to `Config\GenAI_Key.txt` inside your extracted workspace.

## Step 2: Extract & Install AgentOS

Deploy the operating system workspace on your local machine using the built-in auto-sensing environment wizard:

Phase | Action Required | Under-the-Hood Behavior
--- | --- | ---
Extraction | Extract the `Prototype 0.zip` file completely to a local folder you control, such as `MoA` under Documents or another non-system workspace. | Preserves folder structures: `Config\`, `Skills\`, `Library\`, and `Memory\`.
Configuration | Double-click `Install Mix of Agents.bat` in the root folder. | Launches the automated Setup Wizard to link your API key and map local resources.
Python Mapping | Follow the wizard prompts to define your API endpoint and enter your API Key. | Auto-Sensing Environment: Automatically scans for standard python, ArcGIS Pro installations, or deploys the bundled pre-packaged portable python environment.
Activation | The wizard creates a `Start AgentOS.bat` direct link on your Desktop. | Establishes a localized console environment fully prepped to execute workspace tasks.

## Step 3: Run & Employ AgentOS

Double-click the newly generated `Start AgentOS.bat` on your desktop. This boots the command interface. You have immediate access to the following central capabilities:

### Basic Console Interactions

The console behaves exactly like an interactive operational terminal. You can write instructions in natural language or utilize localized slash commands:

Slash Command | Action Executed
--- | ---
`/help` | Renders the comprehensive, system command-mapping menu.
`/session` | Performs a deep wipe on all session states and chat memory to start fresh.
`/load [filename]` | Injects the content of a project file directly into the current LLM context window.
`/model [model-id]` | Switches the active LLM context engine on the fly (e.g., to `gemini-3.5-flash`).

### Mixture-of-Agents (MoA) Workspace

Execute advanced multi-agent operations where specialized background agents (Supervisor, DataProcessor, MemoryManager, Watchdog) negotiate tasks collaboratively:

    \[ RUN\_SKILL : Scripts\AgentOS.ps1 \]

This command terminates any lingering orphan threads, spins up 5 isolated background execution workers, and opens the visual Mix of Agents Dashboard in Edge/Chrome safely.

### High-Fidelity File Ingestion

Drag and drop any binary report, spreadsheet, or PDF directly into the active console window. The system automatically intercepts the action, passes the file path to the native Python parsing engine, extracts tables or text, and loads them into your context window instantly for processing.

SECURITY NOTE: Always run AgentOS within approved organizational workspace boundaries. All processing, calculations, and agent collaboration scripts are completely local, ensuring your raw project data never leaks outside the system bounds.