# GETTING STARTED

#### Backend API

* **FastAPI**: CRUD, CORS, error handling, logging.
* **Persistence**: JSON storage, backup/recovery.
* **File Handling**: ZIP upload/extract, validation.
* **Real-time**: Data sync for plugins, extensions, templates.

#### Frontend Dashboard

* **React/TypeScript**: Monaco editor, Zustand state.
* **Live Integration**: Real-time API, HMR, error boundaries.
* **Template Management**: Multi-framework codegen, upload, preview.
* **Responsive UI**: Dark theme, modern UX.

#### Developer Features

* **Type-safe API**: End-to-end TypeScript.
* **Framework Ops**: Enable/disable, install/uninstall.
* **Live Status**: Real-time updates, fallback systems.

### Documentation

* **Backend-Frontend Integration**
* **Quick Start**
* **API Endpoints**
* **Development Tools**

### Quick Start

#### Backend

```bash
pip install fastapi uvicorn python-multipart psutil
python backend_api.py
```

#### Frontend

```bash
cd frontend/dashboard4
npm install
npm run dev
```

* **Frontend**: http://localhost:3002
* **Backend**: http://localhost:5000
* **Docs**: http://localhost:5000/docs

### API Endpoints

#### Plugins/Extensions

```http
GET/POST/PUT/DELETE  /api/plugins/{id}
GET/POST/PUT/DELETE  /api/extensions/{id}
POST                 /api/plugins/{id}/install
POST                 /api/plugins/{id}/enable
```

#### Templates/Files

```http
POST  /api/templates/upload
GET   /api/templates/{id}/download
GET   /api/templates/{id}/files/{path}
POST  /api/templates
```

#### System

```http
GET   /api/health
GET   /api/system/info
```

### Development Tools

* **Monaco Editor**: IntelliSense, 20+ languages.
* **Live Template Loading**: Direct editor integration.
* **Multi-framework**: React, Vue, Angular, Node.js, Python.
* **Plugin/Extension Dashboards**: Visual management.
* **File Explorer**: Project navigation.
* **HMR**: Instant updates.

### Table of Contents

* Overview
* Architecture
* Quick Start
* Backend API
* Frontend Dashboard
* Development Features
* API Documentation
* Installation
* Usage
* Contributing

### Overview

Artifact Virtual is an open-source platform for real-time management of plugins, extensions, and templates. It features a FastAPI backend and React frontend with live code editing, file upload, and integrated development tools.

* **Goal**: Unified environment for multi-framework, multi-language development.
* **Design**: FastAPI, React, Monaco, type safety, real-time data.

Key systems: AI abstraction, quantum simulation, theorem proving, data analysis, visualization.

**Note**: Docs are auto-generated and may lag behind code.

### Vision

* **DAE**: Decentralized, self-hosted research orgs.
* **Explainability**: Rigorous, auditable protocols.
* **Continuous Evolution**: Transparent, peer-review-ready, open benchmarks.

### Core Systems

#### Arc

* Two-phase blockchain: circular validation, evolvable rules.
* Multi-block feedback, adaptive governance.
* Transparent, auditable, decentralized trust.

#### ADAM Protocol

* Hierarchical agency: substrate, memory, perception, action.
* Mathematical constitution, autonomous teams.
* Arc integration for ethical, distributed decision-making.

#### Quantum Virtual Machine (QVM)

* Quantum-classical simulation: Hamiltonian evolution, tensor networks, noise modeling.
* Lattice-clock timing, Qiskit/Cirq/JAX validation.
* Variational algorithms, OpenQASM roadmap.

### Architecture

Workspace Structure

```
├── core/                    # Orchestration engine
├── administration/          # Bootstrap, AI framework mgmt
├── agents/                  # Multi-agent systems
├── research/                # Portal API, analytics
├── tools/                   # Context mgmt, research pipeline
├── projects/                # Agent foundry, pipelines
├── workshop/worxpace/       # Function registry
├── ecosystem/               # Finance, security, network
├── frontend/                # Angular/React dashboards
└── systems/                 # Orchestrator, automatio
```

### Core Components

* `bootstrap.py`: Automated workspace init.
* `core/aros_orchestrator.py`: Research orchestration.
* `administration/bootstrap_manager.py`: Non-interactive bootstrap.
* `administration/models/ai_framework_manager.py`: Modular AI provider.
* `llm_provider_setup.py`: Provider config/deploy.
* `agents/autonomous_research_team/`: Multi-agent system.
* `agents/MAOS/`: Enterprise agent mgmt.
* `research/portal_api.py`: FastAPI backend.
* `research/portal/`: 3D analytics.
* `tools/real_autonomous_research.py`: Live research.
* `workshop/worxpace/worXpace-os/functions/`: Function registry.
* `functions/admin/security/threat_engine.py`: Threat detection.

### API

```
GET  /api/directory-structure
GET  /api/system-status
POST /api/analysis/start
GET  /api/analysis/real-time-data
```

### Performance

* Bootstrap: <2 min (99.9% success)
* Index: 0.12s/240+ files
* Agent API: <100ms
* Docs: 100KB+ output

### Installation

```bash
python bootstrap.py
python bootstrap.py --quick
python bootstrap.py --status
python bootstrap.py --repair
```

### Tasks

```bash
# VS Code tasks
Bootstrap Workspace
Quick Start
System Status
Repair System
Start AI Framework
```

### Configuration

* `package.json`, `requirements.txt`
* `.vscode/`
* `worxpace/`

### Security

* RBAC, encryption, audit logging
* AI threat detection

### Enterprise

* Multi-tenant, SSO, audit trails
* SOC 2/GDPR compliance

### Documentation

* `/docs/technical/AROS.md`
* `/migration_plan/workspace_deep_dive_analysis.md`
* `/administration/`

### Development

* Cross-platform
* Docker, CMake, CI/C
