LibreAI / AI Agents / LaVague
// agents · lavague-ai/LaVague

LaVague

A Large Action Model framework for building AI web agents that browse and act for you.

★ 6.4k stars⑂ 575 forksApache-2.0updated 2025-01
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

LaVague is an open-source ai agents project by lavague-ai (lavague-ai/LaVague on GitHub). It has 6,395 GitHub stars and 575 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 21 January 2025.

GitHub stars
6,395
Forks
575
License
Apache-2.0
Last updated on GitHub
21 January 2025
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify the web task

    Define the objective your agent should accomplish on a website, in one clear sentence.

  2. Install the framework

    Install LaVague from PyPI and pick a driver — Selenium, Playwright or the Chrome extension.

  3. Configure your LLM

    Connect the multimodal LLM the World Model will use to read pages and plan actions.

  4. Run your first agent

    Launch the Gradio demo or write a short script, give the agent an objective, and watch it act on the page.

// features

Why people love it

World Model planning

A World Model takes your objective plus the current web page state and outputs the set of instructions needed to progress.

Action Engine execution

Instructions are compiled into action code — Selenium or Playwright — and executed against the live page.

Multiple drivers

Supports a Selenium webdriver, a Playwright webdriver and a Chrome extension driver.

Dedicated QA tooling

LaVague QA provides tooling aimed at QA engineers for automated web testing.

Gradio demo

A ready-made Gradio agent demo lets you try web agents interactively without writing integration code first.

Telemetry controls

Data collection is documented in the README, including how to turn telemetry off entirely.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone LaVague to explore the framework and examples.

    git clone https://github.com/lavague-ai/LaVague.git
    cd LaVague
  2. Install the package

    Install LaVague from PyPI.

    pip install lavague
  3. Launch the demo

    Start the Gradio agent demo and give the agent a web objective (see the README's Getting Started for the exact demo command).

    # Launch Gradio Agent Demo — see README for the exact command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains LaVague?

LaVague is maintained by lavague-ai, with documentation at docs.lavague.ai.

Is LaVague free?

The framework is Apache-2.0 licensed and free to use; you pay for the LLM calls your agents make.

Does it need a paid API key?

Yes, in practice: the World Model uses an LLM (the README's examples use GPT-4-class multimodal models), so you need a key for your chosen provider.

How does it compare to browser-use or Selenium alone?

Plain Selenium requires hand-written scripts; LaVague adds an LLM World Model that plans actions from a natural-language objective, then compiles them to Selenium or Playwright.

How do I get started?

pip install lavague, configure your LLM, and run the Gradio demo with a simple objective.

// keep exploring

Similar tools

AI Agents

go-micro

A framework for building agents and services

★ 23.1k starsApache-2.0
View guide →
AI Agents

eve

Vercel's open framework for building agents that run anywhere.

★ 5.5k starsApache-2.0
View guide →
Agents

deepagents-in-action

Chinese guide to building production-grade AI agents with LangChain and LangGraph.

★ 2.6k starsCustom
View guide →
AI Agents

Qwen-AgentWorld

Qwen-AgentWorld: a language world model simulating MCP, terminal, web, and OS environments for agents.

★ 1.0k starsApache-2.0
View guide →
AI Agents

SuperAGI

A dev-first framework for building and running autonomous AI agents.

★ 17.7k starsMIT
View guide →
AI Agents

Agents

A framework for building realtime voice AI agents 🤖🎙️📹

★ 14.5k starsApache-2.0
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if LaVague is not the right fit.

Get LaVague

Free and open — grab the source, star the repo, and start creating.