Welcome to the Omniversal VIP Node.

Quick start · local → git → host

# 1. Unzip this bundle
unzip omniversal_vip_bundle.zip
cd omniversal_vip

# 2. Initialize git (if new)
git init
git add .
git commit -m "Init omniversal.vip console"

# 3. Push to GitHub
git remote add origin <your-github-remote-url>
git push -u origin main

# 4. Deploy to your host (e.g. Cloudflare Pages)
#    Choose "site/" as the build output directory

Minimum viable deployment

• Point omniversal.vip at your static host.
• Serve the site/ directory as the root.
• Add HTTPS + redirects once it’s live.

High-level layout

omniversal_vip/
  site/                      # Static console for omniversal.vip
    index.html
    assets/omniversal-glyph.svg
  notebooks/
    00_overview_omniversal_vip.ipynb
    01_domain_map_builder.ipynb
    02_agents_registry.ipynb
    03_deploy_helpers.ipynb
  scripts/
    sync_omni_env.py
    generate_domain_map.py
  README.md
  .gitignore

Keyboard hint

Open the notebooks in JupyterLab or VS Code, run from the repo root, and keep omni-env.sh on your $PATH for environment sync.

Core notebooks

• 00_overview_omniversal_vip — narrative + config notes for this repo.
• 01_domain_map_builder — define all domains/subdomains and export maps.
• 02_agents_registry — catalog EverLightOS agents, roles, endpoints.
• 03_deploy_helpers — draft deploy commands and config snippets.

sync_omni_env.py (excerpt)

#!/usr/bin/env python3
"""
Sync project-specific environment variables into a shared omni-env.sh file.

- Reads local .env files (e.g. .env, .env.local)
- Appends or updates exports in ../omni-env.sh
- Can be safely run multiple times
"""

from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent
OMNI_ENV = ROOT / "omni-env.sh"

def parse_env_file(path: Path) -> dict:
    data = {}
    for line in path.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith("#"):
            continue
        if "=" in line:
            key, value = line.split("=", 1)
            data[key.strip()] = value.strip()
    return data

if __name__ == "__main__":
    # Implementation lives in scripts/sync_omni_env.py
    pass

Extend as needed

The full script is included in scripts/. Wire it into your shell aliases to keep all projects synced into a single omni-env file.