myra-linux 0.1.0__py3-none-any.whl

website_builder/agents/generator_agent.py

@@ -0,0 +1,249 @@
+# -*- coding: utf-8 -*-
+"""MYRA WebForge — Generator Agent (HTML/CSS/JS)"""
+
+import json, re
+from aria_modules.gemini_rest import FallbackModel
+
+_HAS_GENAI = False
+try:
+  try:
+    import google.genai as genai
+  except Exception:
+    import google.generativeai as genai
+  from website_builder.config import GEMINI_API_KEY
+  try:
+    if hasattr(genai, 'configure'):
+      genai.configure(api_key=GEMINI_API_KEY)
+  except Exception:
+    pass
+  _HAS_GENAI = True
+except Exception:
+  _HAS_GENAI = False
+
+THEME_CSS_VARS = {
+    "dark":          {"bg":"#0a0a0a","bg2":"#111827","text":"#f9fafb","accent":"#3b82f6","accent2":"#06b6d4","card":"#1f2937","border":"rgba(255,255,255,0.1)"},
+    "light":         {"bg":"#ffffff","bg2":"#f8fafc","text":"#0f172a","accent":"#2563eb","accent2":"#0891b2","card":"#f1f5f9","border":"rgba(0,0,0,0.08)"},
+    "glassmorphism": {"bg":"#0f0c29","bg2":"#302b63","text":"#ffffff","accent":"#a78bfa","accent2":"#38bdf8","card":"rgba(255,255,255,0.08)","border":"rgba(255,255,255,0.18)"},
+    "gaming":        {"bg":"#050505","bg2":"#0d0d0d","text":"#ffffff","accent":"#ff0055","accent2":"#ff6600","card":"#111111","border":"rgba(255,0,85,0.3)"},
+    "futuristic_neon":{"bg":"#020014","bg2":"#0a0028","text":"#e0e0ff","accent":"#00ffcc","accent2":"#ff00ff","card":"#0d0030","border":"rgba(0,255,204,0.25)"},
+    "ai_startup":    {"bg":"#050b18","bg2":"#0c1526","text":"#f0f4ff","accent":"#6366f1","accent2":"#06b6d4","card":"#0f1d38","border":"rgba(99,102,241,0.25)"},
+    "portfolio":     {"bg":"#0d1117","bg2":"#161b22","text":"#e6edf3","accent":"#58a6ff","accent2":"#3fb950","card":"#21262d","border":"rgba(88,166,255,0.2)"},
+    "corporate":     {"bg":"#ffffff","bg2":"#f5f7fa","text":"#1a202c","accent":"#1a56db","accent2":"#047857","card":"#edf2f7","border":"rgba(0,0,0,0.1)"},
+    "ecommerce":     {"bg":"#fafafa","bg2":"#f0f0f0","text":"#1a1a1a","accent":"#ff6900","accent2":"#ffd700","card":"#ffffff","border":"rgba(0,0,0,0.1)"},
+}
+
+
+class GeneratorAgent:
+    def __init__(self):
+      if True:  # REST fallback model — SDK pe depend nahi
+        try:
+          self._model = FallbackModel()  # Gemini REST + model fallback chain
+        except Exception:
+          self._model = None
+      else:
+        self._model = None
+
+    def _theme(self, theme: str) -> dict:
+        return THEME_CSS_VARS.get(theme, THEME_CSS_VARS["dark"])
+
+    def generate_html(self, plan: dict, content: dict) -> str:
+        if not self._model:
+            return self._fallback_html(plan, content)
+
+        tv = self._theme(plan.get("theme", "dark"))
+        prompt = f"""
+You are a world-class web developer. Generate a COMPLETE, BEAUTIFUL, PRODUCTION-READY single-page website.
+
+Plan: {json.dumps(plan, indent=2)}
+Content: {json.dumps(content, indent=2)}
+Theme Variables: {json.dumps(tv, indent=2)}
+
+REQUIREMENTS:
+1. Return ONLY complete index.html — no explanation, no markdown fences.
+2. Inline all CSS in <style> tag, inline all JS in <script> tag.
+3. Mobile-responsive with CSS Grid/Flexbox.
+4. Smooth scroll + Intersection Observer animations.
+5. Navigation bar with all section links + hamburger for mobile.
+6. Sections: {', '.join(plan.get('sections', ['hero','about','services','contact']))}.
+7. Footer with copyright.
+8. Use theme CSS variables exactly as provided.
+9. Glass cards if glassmorphism theme. Particle/glow effects if gaming/neon theme.
+10. SEO meta tags: title, description, og:title, og:description.
+11. Modern premium look — NOT generic.
+12. Smooth hover effects on all buttons and cards.
+
+Generate the complete HTML now:
+"""
+        try:
+            resp = self._model.generate_content(
+                prompt,
+                generation_config={"temperature": 0.7, "max_output_tokens": 8192}
+            )
+            html = resp.text.strip()
+            html = re.sub(r"^```(?:html)?\s*", "", html)
+            html = re.sub(r"\s*```$", "", html)
+            return html
+        except Exception as e:
+            print(f"[Generator] HTML failed: {e}")
+            return self._fallback_html(plan, content)
+
+    def generate_css(self, plan: dict) -> str:
+        tv = self._theme(plan.get("theme", "dark"))
+        return f"""/* MYRA WebForge — {plan.get('title','Website')} */
+:root {{
+  --bg: {tv['bg']}; --bg2: {tv['bg2']}; --text: {tv['text']};
+  --accent: {tv['accent']}; --accent2: {tv['accent2']};
+  --card: {tv['card']}; --border: {tv['border']};
+}}
+* {{ margin:0; padding:0; box-sizing:border-box; }}
+body {{ background:var(--bg); color:var(--text); font-family:'{plan.get('font_family','Segoe UI')}',sans-serif; }}
+a {{ color:var(--accent); text-decoration:none; }}
+"""
+
+    def generate_js(self, plan: dict) -> str:
+        return """// MYRA WebForge Script
+document.addEventListener('DOMContentLoaded', () => {
+  document.querySelectorAll('a[href^="#"]').forEach(a => {
+    a.addEventListener('click', e => {
+      e.preventDefault();
+      const el = document.querySelector(a.getAttribute('href'));
+      if (el) el.scrollIntoView({ behavior: 'smooth' });
+    });
+  });
+  const obs = new IntersectionObserver(entries => {
+    entries.forEach(e => { if (e.isIntersecting) e.target.classList.add('visible'); });
+  }, { threshold: 0.1 });
+  document.querySelectorAll('.animate').forEach(el => obs.observe(el));
+  const tog = document.querySelector('.nav-toggle');
+  const nav = document.querySelector('.nav-menu');
+  if (tog && nav) tog.addEventListener('click', () => nav.classList.toggle('open'));
+});
+"""
+
+    def generate_readme(self, plan: dict, live_url: str = "") -> str:
+        return f"""# {plan.get('title', plan.get('project_name','Website'))}
+> {plan.get('tagline','Built with MYRA WebForge AI')}
+
+## 🚀 Live URL
+{live_url if live_url else '_Deploying..._'}
+
+## About
+- **Type:** {plan.get('website_type','website')}
+- **Theme:** {plan.get('theme','dark')}
+- **Stack:** {plan.get('tech_stack','HTML, CSS, JS')}
+
+_Generated by MYRA WebForge AI_
+"""
+
+    def _fallback_html(self, plan: dict, content: dict) -> str:
+        tv      = self._theme(plan.get("theme", "dark"))
+        title   = plan.get("title", "My Website")
+        tagline = plan.get("tagline", "Built with MYRA WebForge")
+        hero    = content.get("hero", {})
+        heading = hero.get("heading", title)
+        sub     = hero.get("subheading", tagline)
+        cta     = hero.get("cta_primary", "Get Started")
+        svcs    = content.get("services", {}).get("items", [])
+        svc_html = ""
+        for s in svcs:
+            svc_html += f'<div class="card"><div class="card-icon">{s.get("icon","⚡")}</div><h3>{s.get("title","")}</h3><p>{s.get("description","")}</p></div>'
+        contact  = content.get("contact", {})
+        footer   = content.get("footer", {})
+        seo      = content.get("seo", {})
+        return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1.0">
+<title>{seo.get('meta_title', title)}</title>
+<meta name="description" content="{seo.get('meta_description', tagline)}">
+<meta property="og:title" content="{seo.get('og_title', title)}">
+<meta property="og:description" content="{seo.get('og_description', tagline)}">
+<style>
+:root{{--bg:{tv['bg']};--bg2:{tv['bg2']};--text:{tv['text']};--accent:{tv['accent']};--accent2:{tv['accent2']};--card:{tv['card']};--border:{tv['border']};}}
+*{{margin:0;padding:0;box-sizing:border-box;}}
+body{{background:var(--bg);color:var(--text);font-family:'{plan.get('font_family','Segoe UI')}',sans-serif;}}
+nav{{position:fixed;top:0;width:100%;background:var(--bg2);border-bottom:1px solid var(--border);padding:1rem 2rem;display:flex;justify-content:space-between;align-items:center;z-index:100;}}
+nav .brand{{font-size:1.4rem;font-weight:bold;color:var(--accent);}}
+nav ul{{display:flex;gap:2rem;list-style:none;}}
+nav a{{color:var(--text);opacity:0.8;transition:opacity 0.3s;}}
+nav a:hover{{opacity:1;color:var(--accent);}}
+section{{padding:6rem 2rem;max-width:1100px;margin:0 auto;}}
+#hero{{text-align:center;min-height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center;padding-top:5rem;}}
+#hero h1{{font-size:clamp(2rem,5vw,4rem);font-weight:900;margin-bottom:1.5rem;background:linear-gradient(135deg,var(--accent),var(--accent2));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text;}}
+#hero p{{font-size:1.2rem;opacity:0.75;max-width:600px;margin:0 auto 2.5rem;line-height:1.7;}}
+.btn{{display:inline-block;padding:0.9rem 2.5rem;background:var(--accent);color:#fff;border-radius:50px;font-weight:bold;font-size:1rem;transition:all 0.3s;margin:0.4rem;}}
+.btn:hover{{transform:translateY(-2px);box-shadow:0 8px 25px rgba(0,0,0,0.3);opacity:0.9;}}
+.btn-outline{{background:transparent;border:2px solid var(--accent);color:var(--accent);}}
+h2{{font-size:2.2rem;font-weight:800;margin-bottom:3rem;text-align:center;}}
+h2 span{{color:var(--accent);}}
+.grid{{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:1.8rem;}}
+.card{{background:var(--card);border:1px solid var(--border);border-radius:16px;padding:2rem;transition:transform 0.3s,box-shadow 0.3s;}}
+.card:hover{{transform:translateY(-6px);box-shadow:0 20px 40px rgba(0,0,0,0.2);}}
+.card-icon{{font-size:2.5rem;margin-bottom:1rem;}}
+.card h3{{font-size:1.1rem;font-weight:700;margin-bottom:0.6rem;}}
+.card p{{opacity:0.7;line-height:1.6;font-size:0.95rem;}}
+#contact{{text-align:center;}}
+.contact-info{{display:flex;flex-wrap:wrap;justify-content:center;gap:2rem;margin-top:2rem;}}
+.contact-item{{background:var(--card);border:1px solid var(--border);border-radius:12px;padding:1.5rem 2rem;}}
+footer{{background:var(--bg2);border-top:1px solid var(--border);text-align:center;padding:2.5rem;opacity:0.7;margin-top:4rem;}}
+@media(max-width:768px){{nav ul{{display:none;}}}}
+.animate{{opacity:0;transform:translateY(24px);transition:opacity 0.6s,transform 0.6s;}}
+.animate.visible{{opacity:1;transform:translateY(0);}}
+</style>
+</head>
+<body>
+<nav>
+  <span class="brand">{title}</span>
+  <ul>
+    <li><a href="#about">About</a></li>
+    <li><a href="#services">Services</a></li>
+    <li><a href="#contact">Contact</a></li>
+  </ul>
+</nav>
+<section id="hero">
+  <h1>{heading}</h1>
+  <p>{sub}</p>
+  <div>
+    <a class="btn" href="#services">{cta}</a>
+    <a class="btn btn-outline" href="#contact">Contact Us</a>
+  </div>
+</section>
+<section id="about" class="animate">
+  <h2>About <span>Us</span></h2>
+  <p style="text-align:center;opacity:0.75;max-width:700px;margin:0 auto;line-height:1.8;">{content.get('about',{}).get('description','We create amazing digital experiences.')}</p>
+</section>
+<section id="services">
+  <h2>What We <span>Offer</span></h2>
+  <div class="grid">{svc_html}</div>
+</section>
+<section id="contact" class="animate">
+  <h2>Get In <span>Touch</span></h2>
+  <p style="opacity:0.7;margin-bottom:2rem;">{contact.get('subheading','We would love to hear from you')}</p>
+  <div class="contact-info">
+    <div class="contact-item">📧 {contact.get('email','hello@myra.ai')}</div>
+    <div class="contact-item">📞 {contact.get('phone','+1 (555) 000-0000')}</div>
+    <div class="contact-item">📍 {contact.get('address','123 Main Street')}</div>
+  </div>
+</section>
+<footer>
+  <p>{footer.get('tagline','Built with MYRA WebForge AI')}</p>
+  <p style="margin-top:0.5rem;font-size:0.85rem;">{footer.get('copyright',f'© 2025 {title}. All rights reserved.')}</p>
+</footer>
+<script>
+document.addEventListener('DOMContentLoaded', () => {{
+  document.querySelectorAll('a[href^="#"]').forEach(a => {{
+    a.addEventListener('click', e => {{
+      e.preventDefault();
+      const el = document.querySelector(a.getAttribute('href'));
+      if (el) el.scrollIntoView({{ behavior: 'smooth' }});
+    }});
+  }});
+  const obs = new IntersectionObserver(entries => {{
+    entries.forEach(e => {{ if (e.isIntersecting) e.target.classList.add('visible'); }});
+  }}, {{ threshold: 0.1 }});
+  document.querySelectorAll('.animate').forEach(el => obs.observe(el));
+}});
+</script>
+</body>
+</html>"""

website_builder/agents/planner_agent.py

@@ -0,0 +1,175 @@
+from aria_modules.gemini_rest import FallbackModel
+# -*- coding: utf-8 -*-
+"""MYRA WebForge — Planner Agent"""
+
+import json
+import re
+
+_HAS_GENAI = False
+try:
+    try:
+        import google.genai as genai
+    except Exception:
+        import google.generativeai as genai
+    from website_builder.config import GEMINI_API_KEY
+    try:
+        # configure if available (some libs may not need this)
+        if hasattr(genai, 'configure'):
+            genai.configure(api_key=GEMINI_API_KEY)
+    except Exception:
+        # non-fatal: proceed without configured client
+        pass
+    _HAS_GENAI = True
+except Exception:
+    _HAS_GENAI = False
+
+WEBSITE_KEYWORDS = [
+    "website", "site", "webpage", "web page", "landing page",
+    "portfolio", "blog", "store", "shop", "ecommerce", "e-commerce",
+    "deploy", "publish", "preview", "github", "vercel", "hosting",
+    "create web", "build web", "make web", "generate web",
+    "update website", "edit website", "add section", "change theme",
+]
+
+ACTION_PATTERNS = {
+    "create":  ["create", "make", "build", "generate", "banao", "bana", "likho"],
+    "update":  ["update", "edit", "change", "modify", "add section", "improve", "badlo"],
+    "preview": ["preview", "open", "show", "dekho", "local"],
+    "deploy":  ["deploy", "publish", "live", "push", "upload"],
+    "status":  ["status", "info", "url", "link", "check"],
+}
+
+THEME_MAP = {
+    "dark":          "dark",
+    "light":         "light",
+    "glass":         "glassmorphism",
+    "glassmorphism": "glassmorphism",
+    "gaming":        "gaming",
+    "neon":          "futuristic_neon",
+    "futuristic":    "futuristic_neon",
+    "corporate":     "corporate",
+    "portfolio":     "portfolio",
+    "ai":            "ai_startup",
+    "startup":       "ai_startup",
+    "minimal":       "light",
+}
+
+TYPE_MAP = {
+    "portfolio": "portfolio",
+    "gaming":    "gaming",
+    "game":      "gaming",
+    "ai":        "ai_startup",
+    "startup":   "ai_startup",
+    "business":  "business",
+    "ecommerce": "ecommerce",
+    "store":     "ecommerce",
+    "shop":      "ecommerce",
+    "blog":      "blog",
+    "landing":   "landing",
+    "saas":      "saas",
+}
+
+
+class PlannerAgent:
+    def __init__(self):
+        # Some SDKs (google.genai) may have a different API surface.
+        # Only instantiate if the loaded module exposes the expected class.
+        if True:  # REST fallback model — SDK pe depend nahi
+            try:
+                self._model = FallbackModel()  # Gemini REST + model fallback chain
+            except Exception:
+                self._model = None
+        else:
+            self._model = None
+
+    def is_webforge_command(self, command: str) -> bool:
+        cmd = command.lower()
+        return any(kw in cmd for kw in WEBSITE_KEYWORDS)
+
+    def detect_action(self, command: str) -> str:
+        cmd = command.lower()
+        for action, keywords in ACTION_PATTERNS.items():
+            if any(kw in cmd for kw in keywords):
+                return action
+        return "create"
+
+    def detect_type(self, command: str) -> str:
+        cmd = command.lower()
+        for key, val in TYPE_MAP.items():
+            if key in cmd:
+                return val
+        return "portfolio"
+
+    def detect_theme(self, command: str) -> str:
+        cmd = command.lower()
+        for key, val in THEME_MAP.items():
+            if key in cmd:
+                return val
+        defaults = {"gaming": "gaming", "ai_startup": "ai_startup",
+                    "ecommerce": "light", "portfolio": "dark"}
+        return defaults.get(self.detect_type(command), "dark")
+
+    def generate_project_name(self, command: str, wtype: str) -> str:
+        stop = {"create","make","build","generate","website","site","a","an","the",
+                "for","me","please","bana","banao","kar","do","mujhe","meri","mera","ek"}
+        words = re.sub(r"[^a-z0-9 ]", "", command.lower()).split()
+        parts = [w for w in words if w not in stop][:3]
+        return "-".join(parts) if parts else wtype + "-site"
+
+    def plan(self, command: str) -> dict:
+        action = self.detect_action(command)
+        wtype  = self.detect_type(command)
+        theme  = self.detect_theme(command)
+        name   = self.generate_project_name(command, wtype)
+
+        if self._model:
+            prompt = f"""
+You are a website planner AI. Based on this user command, create a structured JSON plan.
+User command: "{command}"
+Detected type: {wtype}, theme: {theme}
+
+Return ONLY valid JSON (no markdown):
+{{
+  "project_name": "{name}",
+  "website_type": "{wtype}",
+  "theme": "{theme}",
+  "pages": ["index"],
+  "sections": ["hero","about","services","contact"],
+  "title": "Website title",
+  "tagline": "Short tagline",
+  "primary_color": "#hex",
+  "secondary_color": "#hex",
+  "font_family": "font name",
+  "features": ["responsive","animations","SEO"],
+  "tech_stack": "html_css_js"
+}}
+"""
+            try:
+                resp = self._model.generate_content(prompt)
+                raw  = re.sub(r"```(?:json)?|```", "", resp.text.strip()).strip()
+                plan = json.loads(raw)
+            except Exception as e:
+                print(f"[Planner] AI failed ({e}), using defaults")
+                plan = self._default_plan(name, wtype, theme)
+        else:
+            plan = self._default_plan(name, wtype, theme)
+
+        plan["action"]       = action
+        plan["user_command"] = command
+        return plan
+
+    def _default_plan(self, name, wtype, theme) -> dict:
+        return {
+            "project_name":   name,
+            "website_type":   wtype,
+            "theme":          theme,
+            "pages":          ["index"],
+            "sections":       ["hero","about","services","contact"],
+            "title":          name.replace("-"," ").title(),
+            "tagline":        "Built with MYRA WebForge AI",
+            "primary_color":  "#0055FF",
+            "secondary_color":"#00DDFF",
+            "font_family":    "Segoe UI",
+            "features":       ["responsive","animations","SEO"],
+            "tech_stack":     "html_css_js",
+        }

website_builder/config.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+"""
+MYRA WebForge — Configuration
+Loads all keys from .env — NO hardcoding ever.
+"""
+import os
+from pathlib import Path
+
+try:
+    from dotenv import load_dotenv
+    # Explicit path only - never bare load_dotenv(). Bare load_dotenv()
+    # calls find_dotenv(), which walks the call stack via frame.f_back
+    # to guess the caller's directory. When MYRA runs from the packaged
+    # myra.exe launcher (a zipapp-style entry point), that stack is too
+    # shallow and find_dotenv() raises a bare `AssertionError` (empty
+    # message) - which isn't an ImportError, so it wasn't caught here,
+    # and broke `import website_builder` (and anything importing it,
+    # e.g. aria.py) for every pip-installed user.
+    _env_path = Path.cwd() / ".env"
+    if not _env_path.exists():
+        _env_path = Path(__file__).resolve().parents[1] / ".env"
+    if _env_path.exists():
+        load_dotenv(_env_path)
+except ImportError:
+    pass  # dotenv optional — keys can come from environment directly
+
+# ── API Keys (from .env only) ──────────────────────────────────
+GEMINI_API_KEY  = os.getenv("GEMINI_API_KEY", "")
+GITHUB_TOKEN    = os.getenv("GITHUB_TOKEN", "")
+GITHUB_USERNAME = os.getenv("GITHUB_USERNAME", "")
+VERCEL_TOKEN    = os.getenv("VERCEL_TOKEN", "")
+VERCEL_TEAM_ID  = os.getenv("VERCEL_TEAM_ID", "")
+
+# ── Paths ──────────────────────────────────────────────────────
+PROJECTS_DIR = Path(os.getenv("PROJECTS_DIR", "Projects"))
+PROJECTS_DIR.mkdir(exist_ok=True)
+DB_PATH      = PROJECTS_DIR / "webforge_projects.json"
+
+# ── Deploy provider ────────────────────────────────────────────
+DEFAULT_DEPLOY_PROVIDER = os.getenv("DEFAULT_DEPLOY_PROVIDER", "vercel")
+
+def validate_keys() -> dict:
+    missing = []
+    if not GEMINI_API_KEY:   missing.append("GEMINI_API_KEY")
+    if not GITHUB_TOKEN:     missing.append("GITHUB_TOKEN")
+    if not GITHUB_USERNAME:  missing.append("GITHUB_USERNAME")
+    if not VERCEL_TOKEN:     missing.append("VERCEL_TOKEN")
+    return {"ok": len(missing) == 0, "missing": missing}

website_builder/database/__init__.py

@@ -0,0 +1 @@
+# website_builder database package

website_builder/database/projects_db.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+"""MYRA WebForge — Projects Database (JSON-backed)"""
+
+import json
+import threading
+from datetime import datetime
+from website_builder.config import DB_PATH
+
+
+class ProjectsDB:
+    _lock = threading.Lock()
+
+    def __init__(self):
+        self._path = DB_PATH
+        self._data = self._load()
+
+    def _load(self) -> dict:
+        if self._path.exists():
+            try:
+                return json.loads(self._path.read_text(encoding="utf-8"))
+            except Exception:
+                pass
+        return {}
+
+    def _save(self):
+        self._path.write_text(
+            json.dumps(self._data, indent=2, ensure_ascii=False),
+            encoding="utf-8"
+        )
+
+    def get(self, project_name: str):
+        with self._lock:
+            return self._data.get(project_name)
+
+    def save_project(self, project_name: str, info: dict):
+        with self._lock:
+            existing = self._data.get(project_name, {})
+            existing.update(info)
+            existing["updated_at"] = datetime.now().isoformat()
+            if "created_at" not in existing:
+                existing["created_at"] = existing["updated_at"]
+            self._data[project_name] = existing
+            self._save()
+
+    def all_projects(self) -> list:
+        with self._lock:
+            return list(self._data.values())

website_builder/deploy/__init__.py

@@ -0,0 +1 @@
+# website_builder deploy package

website_builder/deploy/github_service.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+"""MYRA WebForge — GitHub Service"""
+
+import base64, requests
+from pathlib import Path
+from website_builder.config import GITHUB_TOKEN, GITHUB_USERNAME
+
+BASE = "https://api.github.com"
+
+
+class GitHubService:
+    def __init__(self):
+        self._h = {
+            "Authorization": f"token {GITHUB_TOKEN}",
+            "Accept":        "application/vnd.github.v3+json",
+            "Content-Type":  "application/json",
+        }
+
+    def repo_exists(self, repo: str) -> bool:
+        r = requests.get(f"{BASE}/repos/{GITHUB_USERNAME}/{repo}", headers=self._h, timeout=30)
+        return r.status_code == 200
+
+    def create_repo(self, repo: str, desc: str = "") -> dict:
+        data = {"name": repo, "description": desc or f"MYRA WebForge — {repo}",
+                "private": False, "auto_init": False}
+        r = requests.post(f"{BASE}/user/repos", headers=self._h, json=data, timeout=30)
+        if r.status_code in (201, 422):
+            return {"ok": True, "url": f"https://github.com/{GITHUB_USERNAME}/{repo}"}
+        return {"ok": False, "error": r.text[:200]}
+
+    def _sha(self, repo: str, path: str):
+        r = requests.get(f"{BASE}/repos/{GITHUB_USERNAME}/{repo}/contents/{path}",
+                         headers=self._h, timeout=30)
+        return r.json().get("sha") if r.status_code == 200 else None
+
+    def push_file(self, repo: str, path: str, content, msg: str) -> bool:
+        if isinstance(content, str): content = content.encode("utf-8")
+        b64  = base64.b64encode(content).decode()
+        sha  = self._sha(repo, path)
+        data = {"message": msg, "content": b64}
+        if sha: data["sha"] = sha
+        r = requests.put(f"{BASE}/repos/{GITHUB_USERNAME}/{repo}/contents/{path}",
+                         headers=self._h, json=data, timeout=30)
+        return r.status_code in (200, 201)
+
+    def push_project(self, repo: str, project_dir: Path) -> dict:
+        if not GITHUB_TOKEN or not GITHUB_USERNAME:
+            return {"ok": False, "error": "GITHUB_TOKEN or GITHUB_USERNAME missing in .env"}
+        if not self.repo_exists(repo):
+            res = self.create_repo(repo)
+            if not res["ok"]: return res
+
+        msg    = f"MYRA WebForge update: {repo}"
+        pushed = []
+        failed = []
+        for fp in project_dir.rglob("*"):
+            if not fp.is_file(): continue
+            rel = fp.relative_to(project_dir).as_posix()
+            try:
+                ok = self.push_file(repo, rel, fp.read_bytes(), msg)
+                (pushed if ok else failed).append(rel)
+            except Exception as e:
+                failed.append(f"{rel}({e})")
+
+        url = f"https://github.com/{GITHUB_USERNAME}/{repo}"
+        print(f"[GitHub] Pushed {len(pushed)} files → {url}")
+        return {"ok": len(pushed) > 0, "github_url": url, "pushed": len(pushed), "failed": failed}