How neuhai/uxagent works
Project type and purpose
• UXAgent is a Python-based framework that uses LLMs as autonomous agents to conduct web usability tests.
• It simulates user personas against any web page via a “Universal Web Connector,” collecting feedback and design insights automatically.
File structure
• Top-level: configuration (environment.yml, pyproject.toml), persona data (example_data/personas), figures.
• src/simulated_web_agent: the core package.
• agent/: LLM orchestration—context management, memory, prompt templates, GPT wrapper.
• executor/: web‐driving layer—Selenium/Chromedriver environment setup (env.py) plus site‐specific “recipes” for actions (e.g., amazon_recipes.py).
• main/: CLI entrypoints (__main__.py), persona generation (persona.py), experiment replay (replay.py), model definitions.
README for additional insights
• Dual-system reasoning: quick decisions (System 1) vs. in-depth analysis (System 2).
• Universal Web Connector: adapter to drive any web UI via Selenium.
• Supports OpenAI/AWS Claude as LLM backends.
• Personas stored as JSON/TXT; used to parameterize agent behavior.
Detail
• Sub-components: Prompt Library, Memory Store, site recipes.
• Sense-plan-act loop clearly.
• Don’t omit the Universal Web Connector as a key adapter layer.
• Optional headful vs. headless mode via an environment flag.
• Dependencies: environment.yml, pyproject.toml, chromedriver.