Skip to content

🏠 Home

πŸ„β€β™€οΈ What is LaVague?

LaVague is an open-source Large Action Model framework for turning natural language into browser actions.

At LaVague's core, we have an Action Engine which uses advanced AI techniques (RAG, Few-shot learning, Chain of Thought) to β€œcompile” natural language instructions into browser automation code, by leveraging Selenium or Playwright.

LaVague in Action

Here's an example of LaVague being used to execute natural language instructions on a browser to automate web interactions. This example uses the Gradio interface available with the lavague launch CLI command:

LaVague Interaction Example

πŸš€ Getting Started

Running LaVague in your local env

You can get started with LaVague in 2 steps:

  1. Install LaVague & dependencies
wget &&
  1. Run your LaVague command!
lavague --instructions examples/instructions/huggingface.yaml --config examples/configurations/api/ build

For a step-by-step guide or to run LaVague in a Google Colab, see our quick-tour which will walk you through how to get set-up and launch LaVague with our CLI tool.

🎭 Playwright integration

If you want to get started with LaVague build using Playwright as your underlying automation tool, see our Playwright integration guide

πŸ™‹ Contributing

We would love your help and support on our quest to build a robust and reliable Large Action Model for web automation.

To avoid having multiple people working on the same things & being unable to merge your work, we have outlined the following contribution process:

1) πŸ“’ We outline tasks on our backlog: we recommend you check out issues with the help-wanted labels & good first issue labels

2) πŸ™‹β€β™€οΈ If you are interested in working on one of these tasks, comment on the issue!

3) 🀝 We will discuss with you and assign you the task with a community assigned label

4) πŸ’¬ We will then be available to discuss this task with you

5) ⬆️ You should submit your work as a PR

6) βœ… We will review & merge your code or request changes/give feedback

Please check out our contributing guide for a more detailed guide.

If you want to ask questions, contribute, or have proposals, please come on our Discord to chat!

πŸ—ΊοΈ Roadmap

TO keep up to date with our project backlog here.


This project executes LLM-generated code using exec. This is not considered a safe practice. We therefore recommend taking extra care when using LaVague (such as running LaVague in a sandboxed environment)!