┌─────────────────────────────────────────────────────┐
│                   Cloud Run Instance                 │
├─────────────────────────────────────────────────────┤
│  ┌─────────────────┐    ┌─────────────────────────┐ │
│  │  React Frontend │◄──►│  FastAPI Backend        │ │
│  │  (Terminal UI)  │    │  - Agent Core           │ │
│  └─────────────────┘    │  - Governance Layer     │ │
│                         │  - MCP Server           │ │
│                         └───────────┬─────────────┘ │
│                                     │               │
│                         ┌───────────▼─────────────┐ │
│                         │  Tools                  │ │
│                         │  - query_resume         │ │
│                         │  - verify_employment    │ │
│                         │  - audit_project        │ │
│                         └─────────────────────────┘ │
└─────────────────────────────────────────────────────┘

# Clone the repository
cd Atlas-G\ Protocol

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

# Copy environment template
cp .env.example .env
# Edit .env with your GOOGLE_API_KEY

# Start the server
uvicorn backend.main:application --reload --port 8080

# Open http://localhost:8080

pytest backend/tests/ -v

{
  "mcpServers": {
    "atlas-g-protocol": {
      "command": "python",
      "args": ["-m", "backend.mcp_server"]
    }
  }
}

gcloud run deploy atlas-g-portfolio \
  --source . \
  --allow-unauthenticated \
  --region us-central1 \
  --labels dev-tutorial=devnewyear2026 \
  --set-env-vars GOOGLE_API_KEY=your_key_here

Atlas-G Protocol/
├── backend/
│   ├── __init__.py
│   ├── main.py          # FastAPI application
│   ├── agent.py         # Thought-Action loop
│   ├── governance.py    # Hallucination mitigation
│   ├── mcp_server.py    # FastMCP wrapper
│   ├── config.py        # Settings management
│   └── tools/
│       ├── resume_rag.py
│       └── verification.py
├── frontend/            # React UI (Phase 3)
├── data/
│   └── resume.txt       # Knowledge graph source
├── Dockerfile
├── pyproject.toml
└── mcp_config.json