create-browser-app 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

create_browser_app/__init__.py

@@ -0,0 +1,3 @@
+from .main import main
+
+__all__ = ["main"]

main.py → create_browser_app/main.py

@@ -9,112 +9,14 @@ from rich.prompt import Prompt, Confirm
 from rich.panel import Panel
 from rich.text import Text
 import shutil
+from .templates import TEMPLATE_BASIC, TEMPLATE_REQUIREMENTS, TEMPLATE_ENV, TEMPLATE_README, TEMPLATE_GITIGNORE
+from .template_fetcher import get_template_by_name, fetch_template_content
 
 console = Console()
 
-TEMPLATE_BASIC = '''from stagehand import Stagehand
-import asyncio
-
-async def main():
-    """Basic Stagehand browser automation example."""
-    async with Stagehand() as stagehand:
-        page = stagehand.page
-
-        # Navigate to a website
-        await page.goto("https://example.com")
-
-        # Your automation code here
-        print(f"Page title: {await page.title()}")
-
-if __name__ == "__main__":
-    asyncio.run(main())
-'''
-
-TEMPLATE_REQUIREMENTS = '''stagehand
-python-dotenv
-'''
-
-TEMPLATE_ENV = '''# Add your environment variables here
-# BROWSERBASE_API_KEY=your_api_key_here
-# BROWSERBASE_PROJECT_ID=your_project_id_here
-'''
-
-TEMPLATE_README = '''# {project_name}
-
-A Stagehand browser automation project.
-
-## Setup
-
-1. Install dependencies:
-```bash
-pip install -r requirements.txt
-```
-
-2. Configure your environment variables in `.env`:
-```bash
-BROWSERBASE_API_KEY=your_api_key_here
-BROWSERBASE_PROJECT_ID=your_project_id_here
-```
-
-3. Run the project:
-```bash
-python main.py
-```
-
-## About Stagehand
-
-Stagehand is a Python library for browser automation built on Playwright. Learn more at:
-- [Stagehand Documentation](https://github.com/browserbase/stagehand)
-- [Browserbase](https://browserbase.com)
-'''
-
-TEMPLATE_GITIGNORE = '''# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-
-# Virtual Environment
-venv/
-ENV/
-env/
-.venv
-
-# Environment variables
-.env
-.env.local
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-.DS_Store
-
-# Logs
-*.log
-'''
-
 @click.command()
 @click.argument('name', default='my-stagehand-app', required=False)
-@click.option('--template', '-t', default='basic', help='Template to get started with')
+@click.option('--template', '-t', default='basic', help='Template to use (basic or GitHub examples: quickstart, example, agent-example)')
 def main(name, template):
     """Start your Stagehand project with a single command"""
 
@@ -152,9 +54,26 @@ def main(name, template):
         # Create directories
         project_path.mkdir(parents=True, exist_ok=True)
 
+        # Determine which template to use
+        template_content = TEMPLATE_BASIC
+
+        # If not using basic template, try to fetch from GitHub
+        if template != 'basic':
+            console.print(f"Fetching template [cyan]{template}[/cyan] from GitHub...")
+            template_info = get_template_by_name(template)
+            if template_info:
+                fetched_content = fetch_template_content(template_info)
+                if fetched_content:
+                    template_content = fetched_content
+                    console.print(f"[green]✓[/green] Using template from GitHub: {template}")
+                else:
+                    console.print(f"[yellow]⚠[/yellow] Could not fetch template, using basic template")
+            else:
+                console.print(f"[yellow]⚠[/yellow] Template '{template}' not found, using basic template")
+
         # Create main.py
         main_file = project_path / "main.py"
-        main_file.write_text(TEMPLATE_BASIC)
+        main_file.write_text(template_content)
 
         # Create requirements.txt
         requirements_file = project_path / "requirements.txt"
@@ -178,10 +97,9 @@ def main(name, template):
         # Styled next steps
         console.print(Panel(
             f"[bold cyan]1.[/bold cyan] cd {project_dir}\n"
-            f"[bold cyan]2.[/bold cyan] pip install -r requirements.txt\n"
-            f"[bold cyan]3.[/bold cyan] cp .env.example .env\n"
-            f"[bold cyan]4.[/bold cyan] [dim]Add your Browserbase API key to .env[/dim]\n"
-            f"[bold cyan]5.[/bold cyan] python main.py",
+            f"[bold cyan]2.[/bold cyan] cp .env.example .env\n"
+            f"[bold cyan]3.[/bold cyan] [dim]Add your Browserbase API key to .env[/dim]\n"
+            f"[bold cyan]4.[/bold cyan] python main.py",
             title="[bold yellow]🚀 Launch now 🚀[/bold yellow]",
             border_style="yellow",
             padding=(1, 2)

create_browser_app/template_fetcher.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+import urllib.request
+import json
+from typing import Dict, List, Optional
+from pathlib import Path
+import base64
+
+GITHUB_API_BASE = "https://api.github.com"
+REPO_OWNER = "browserbase"
+REPO_NAME = "stagehand-python"
+EXAMPLES_PATH = "examples"
+
+def get_available_templates() -> List[Dict[str, str]]:
+    """Fetch list of available templates from GitHub repository."""
+    try:
+        url = f"{GITHUB_API_BASE}/repos/{REPO_OWNER}/{REPO_NAME}/contents/{EXAMPLES_PATH}"
+        req = urllib.request.Request(url)
+        req.add_header("Accept", "application/vnd.github.v3+json")
+        req.add_header("User-Agent", "create-browser-app-py")
+
+        with urllib.request.urlopen(req) as response:
+            data = json.loads(response.read().decode())
+
+        templates = []
+        for item in data:
+            if item["type"] == "file" and item["name"].endswith(".py"):
+                # Keep the original name without replacing underscores
+                template_name = item["name"].replace(".py", "")
+                templates.append({
+                    "name": template_name,
+                    "filename": item["name"],
+                    "url": item["download_url"],
+                    "api_url": item["url"]
+                })
+
+        return templates
+    except Exception as e:
+        print(f"Error fetching templates: {e}")
+        return []
+
+def fetch_template_content(template_info: Dict[str, str]) -> Optional[str]:
+    """Fetch the content of a specific template from GitHub."""
+    try:
+        url = template_info.get("api_url", template_info.get("url"))
+        req = urllib.request.Request(url)
+        req.add_header("Accept", "application/vnd.github.v3+json")
+        req.add_header("User-Agent", "create-browser-app-py")
+
+        with urllib.request.urlopen(req) as response:
+            data = json.loads(response.read().decode())
+
+        if "content" in data:
+            content = base64.b64decode(data["content"]).decode("utf-8")
+        else:
+            # Fallback to direct download
+            with urllib.request.urlopen(template_info["url"]) as response:
+                content = response.read().decode("utf-8")
+
+        return content
+    except Exception as e:
+        print(f"Error fetching template content: {e}")
+        return None
+
+def get_template_by_name(name: str) -> Optional[Dict[str, str]]:
+    """Get a specific template by name."""
+    templates = get_available_templates()
+    for template in templates:
+        if template["name"] == name:
+            return template
+    return None
+
+def list_templates() -> List[str]:
+    """Get a list of template names."""
+    templates = get_available_templates()
+    return [t["name"] for t in templates]

create_browser_app/templates.py

@@ -0,0 +1,131 @@
+TEMPLATE_BASIC = '''from stagehand import Stagehand
+import asyncio
+import os
+from dotenv import load_dotenv
+from pydantic import BaseModel
+load_dotenv()
+
+async def main():
+    """Basic Stagehand browser automation example."""
+
+    # Check all the configurations in StagehandConfig
+    stagehand = Stagehand(
+        env="LOCAL", # or "BROWSERBASE"
+        verbose=1, # 0: silent, 1: info, 2: debug
+        model_name="gpt-4.1",
+        model_api_key=os.getenv("OPENAI_API_KEY"),
+    )
+    await stagehand.init()
+
+    page = stagehand.page
+    await page.goto("https://docs.stagehand.dev")
+    result = await page.extract("In a few words, what is Stagehand?")
+    print("\n", result, "\n")
+
+    await page.act("click on models")
+    await page.act({
+        "method": "click",
+        "selector": "/html/body[1]/div[2]/div[2]/div[3]/div[2]/div[2]/a[1]",
+        "description": "the model evaluation card",
+        "args": []
+    })
+    elements = await page.observe("find the graph with the list of most accurate models")
+    print("\n", elements, "\n")
+
+    class Model(BaseModel):
+        name: str
+        provider: str
+        accuracy: float
+        
+    extraction = await page.extract(
+        "the most accurate model",
+        schema=Model
+    )
+    print("\n", extraction, "\n")
+
+if __name__ == "__main__":
+    asyncio.run(main())
+
+'''
+
+TEMPLATE_REQUIREMENTS = '''stagehand
+python-dotenv
+'''
+
+TEMPLATE_ENV = '''# Add your environment variables here
+# BROWSERBASE_API_KEY=your_api_key_here
+# BROWSERBASE_PROJECT_ID=your_project_id_here
+'''
+
+TEMPLATE_README = '''# {project_name}
+
+A Stagehand browser automation project.
+
+## Setup
+
+1. Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+2. Configure your environment variables in `.env`:
+```bash
+BROWSERBASE_API_KEY=your_api_key_here
+BROWSERBASE_PROJECT_ID=your_project_id_here
+```
+
+3. Run the project:
+```bash
+python main.py
+```
+
+## About Stagehand
+
+Stagehand is a Python library for browser automation built on Playwright. Learn more at:
+- [Stagehand Documentation](https://github.com/browserbase/stagehand)
+- [Browserbase](https://browserbase.com)
+'''
+
+TEMPLATE_GITIGNORE = '''# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+ENV/
+env/
+.venv
+
+# Environment variables
+.env
+.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+*.log
+'''

{create_browser_app-0.1.2.dist-info → create_browser_app-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: create-browser-app
-Version: 0.1.2
+Version: 0.1.4
 Summary: Start your Stagehand project with a single command
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -8,6 +8,7 @@ Requires-Dist: stagehand
 Requires-Dist: click>=8.0
 Requires-Dist: rich>=13.0
 Requires-Dist: inquirer>=3.0
+Requires-Dist: requests>=2.25.0
 
 # create-browser-app (Python)
 
@@ -21,7 +22,7 @@ uvx create-browser-app
 
 ## What You Get
 
--  Pre-configured Stagehand project
--  Environment setup for Browserbase
--  Ready-to-run example code
--  All dependencies included
+- Pre-configured Stagehand project
+- Environment setup for Browserbase
+- Ready-to-run example code
+- All dependencies included

create_browser_app-0.1.4.dist-info/RECORD

@@ -0,0 +1,9 @@
+create_browser_app/__init__.py,sha256=izlkaSvrxNqPnulbHlD8VYldR618NxRQRlKQFgQn0Gk,42
+create_browser_app/main.py,sha256=eY3dEQK_Qop07SCPNdkOtZKUyX9RnoBJZpmpU_Y1oQI,4789
+create_browser_app/template_fetcher.py,sha256=kfNOFdJlBPjgtAuroVsD-zuXWd04wSpQHTBmYXHDJAc,2723
+create_browser_app/templates.py,sha256=f2YhewO6lStBO-46mfrDXdSQVhGLY0jUgRwjbZG1UpU,2482
+create_browser_app-0.1.4.dist-info/METADATA,sha256=aD65Xl5VoCh0_qRCbhjVkEV7wLnCw3BxcqonxKOr5UA,648
+create_browser_app-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+create_browser_app-0.1.4.dist-info/entry_points.txt,sha256=yyAKhFZs2kraGA_ixwnRZeStL0uxWvBCMzysg8S-0VE,68
+create_browser_app-0.1.4.dist-info/top_level.txt,sha256=sLW8imVtlXvOy1D5aGPBDxbMP3Yvonif7VxcLu_Izy4,19
+create_browser_app-0.1.4.dist-info/RECORD,,

create_browser_app-0.1.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+create-browser-app = create_browser_app.main:main

create_browser_app-0.1.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+create_browser_app

create_browser_app-0.1.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-main.py,sha256=-f8bcxjBgscyy_036mebiBGinRgOouyA4qX1XWrbmFo,5327
-create_browser_app-0.1.2.dist-info/METADATA,sha256=_RG8PCnzjT2tYnp-UFSq4Fq7VgDWfw1b6WnbuTo4xzM,624
-create_browser_app-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-create_browser_app-0.1.2.dist-info/entry_points.txt,sha256=S7VEMgVttj-lbn3gh_gPTJJpwczelIrb5fZgo5ecKHs,49
-create_browser_app-0.1.2.dist-info/top_level.txt,sha256=ZAMgPdWghn6xTRBO6Kc3ML1y3ZrZLnjZlqbboKXc_AE,5
-create_browser_app-0.1.2.dist-info/RECORD,,

create_browser_app-0.1.2.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-create-browser-app = main:main

create_browser_app-0.1.2.dist-info/top_level.txt

@@ -1 +0,0 @@
-main