|
| 1 | +# AgentLab Landing Page |
| 2 | + |
| 3 | +This is a research landing page for AgentLab built using the [Academic Project Page Template](https://github.com/eliahuhorwitz/Academic-project-page-template). |
| 4 | + |
| 5 | +## Structure |
| 6 | + |
| 7 | +``` |
| 8 | +docs/landing_page/ |
| 9 | +├── index.html # Main landing page |
| 10 | +├── projects/ # Individual project pages |
| 11 | +│ ├── browsergym.html # BrowserGym Ecosystem page |
| 12 | +│ ├── webarena.html # WebArena Evaluation page |
| 13 | +│ └── workarena.html # WorkArena Benchmark page |
| 14 | +└── static/ # Static assets |
| 15 | + ├── css/ # Stylesheets |
| 16 | + ├── js/ # JavaScript files |
| 17 | + └── images/ # Images and icons |
| 18 | +``` |
| 19 | + |
| 20 | +## Features |
| 21 | + |
| 22 | +- **Responsive Design**: Built with Bulma CSS framework for mobile-friendly layouts |
| 23 | +- **Project Navigation**: Dropdown menu linking to individual project pages |
| 24 | +- **Academic Template**: Uses the popular academic project page template |
| 25 | +- **Interactive Elements**: Smooth scrolling, animations, and hover effects |
| 26 | +- **Multiple Projects**: Separate pages for BrowserGym, WebArena, and WorkArena |
| 27 | +- **Social Media Ready**: Includes meta tags for social sharing |
| 28 | + |
| 29 | +## Usage |
| 30 | + |
| 31 | +### Viewing Locally |
| 32 | + |
| 33 | +1. Open `index.html` in a web browser |
| 34 | +2. Navigate between project pages using the dropdown menu |
| 35 | +3. All links to external resources (GitHub, arXiv, etc.) are functional |
| 36 | + |
| 37 | +### Hosting |
| 38 | + |
| 39 | +This page can be hosted on: |
| 40 | +- GitHub Pages |
| 41 | +- Netlify |
| 42 | +- Vercel |
| 43 | +- Any static site hosting service |
| 44 | + |
| 45 | +### Customization |
| 46 | + |
| 47 | +1. **Update Content**: Edit the HTML files to update project information |
| 48 | +2. **Add Images**: Replace placeholder images in `static/images/` |
| 49 | +3. **Add Projects**: Create new HTML files in `projects/` directory |
| 50 | +4. **Styling**: Modify `static/css/index.css` for custom styling |
| 51 | + |
| 52 | +## Required Images |
| 53 | + |
| 54 | +The following images should be added to `static/images/`: |
| 55 | + |
| 56 | +1. **favicon.ico** - Site favicon (16x16 or 32x32 px) |
| 57 | +2. **agentlab_overview.png** - Main overview diagram for landing page |
| 58 | +3. **social_preview.png** - Social media preview image (1200x630 px) |
| 59 | + |
| 60 | +Current placeholder images are provided as SVG files. |
| 61 | + |
| 62 | +## Dependencies |
| 63 | + |
| 64 | +The page uses CDN links for: |
| 65 | +- Bulma CSS Framework |
| 66 | +- FontAwesome Icons |
| 67 | +- jQuery |
| 68 | +- Academic Icons |
| 69 | + |
| 70 | +No build process or installation required. |
| 71 | + |
| 72 | +## Project Pages |
| 73 | + |
| 74 | +### BrowserGym Ecosystem (`projects/browsergym.html`) |
| 75 | +- Paper: https://arxiv.org/abs/2412.05467 |
| 76 | +- Code: https://github.com/ServiceNow/BrowserGym |
| 77 | +- Focus: Unified web agent research framework |
| 78 | + |
| 79 | +### WebArena Evaluation (`projects/webarena.html`) |
| 80 | +- Website: https://webarena.dev/ |
| 81 | +- Setup: BrowserGym integration |
| 82 | +- Focus: 812 realistic web tasks |
| 83 | + |
| 84 | +### WorkArena Benchmark (`projects/workarena.html`) |
| 85 | +- Repository: https://github.com/ServiceNow/WorkArena |
| 86 | +- Focus: Enterprise-focused web agent evaluation |
| 87 | +- Levels: L1 (33 tasks), L2/L3 (341 tasks each) |
| 88 | + |
| 89 | +## Deployment |
| 90 | + |
| 91 | +### GitHub Pages (Automatic) |
| 92 | + |
| 93 | +The landing page is automatically deployed to GitHub Pages when changes are pushed to the main branch. The deployment is handled by the GitHub Actions workflow in `.github/workflows/deploy-landing-page.yml`. |
| 94 | + |
| 95 | +**Setup Steps:** |
| 96 | + |
| 97 | +1. Go to your GitHub repository settings |
| 98 | +2. Navigate to "Pages" in the left sidebar |
| 99 | +3. Under "Source", select "GitHub Actions" |
| 100 | +4. The site will be available at: `https://[username].github.io/AgentLab/` |
| 101 | + |
| 102 | +**Manual Trigger:** |
| 103 | + |
| 104 | +You can manually trigger the deployment by going to the "Actions" tab in your GitHub repository and running the "Deploy Landing Page to GitHub Pages" workflow. |
| 105 | + |
| 106 | +### Local Development Server |
| 107 | + |
| 108 | +For local testing: |
| 109 | + |
| 110 | +```bash |
| 111 | +cd docs/landing_page |
| 112 | +python3 -m http.server 8000 |
| 113 | +# Visit http://localhost:8000 |
| 114 | +``` |
| 115 | + |
| 116 | +## Contributing |
| 117 | + |
| 118 | +To add a new project page: |
| 119 | + |
| 120 | +1. Create a new HTML file in `projects/` directory |
| 121 | +2. Use existing project pages as templates |
| 122 | +3. Update the dropdown menu in `index.html` |
| 123 | +4. Add a project card to the main landing page |
| 124 | +5. Include appropriate links and metadata |
| 125 | + |
| 126 | +## License |
| 127 | + |
| 128 | +This template follows the Academic Project Page Template license (Creative Commons Attribution-ShareAlike 4.0 International License). |
| 129 | + |
| 130 | +AgentLab is developed by ServiceNow Research and follows its respective licensing terms. |
0 commit comments