aircodelabs/grasp

Grasp is an open-source and self-hosted agentic browser. With built-in support for MCP and A2A support, it can seamlessly integrate with any other AI apps or agents.
Here’s a quick example of how Grasp works seamlessly with Claude Desktop to make planning your next Airbnb trip:
https://github.com/user-attachments/assets/b55b5f76-4faa-45b9-a5ab-4c4295dfdf19
Some of the key features include:
- **Isolated browser environment**. Grasp is dockerized, ensuring it never interferes with your local workspace. It can be easily hosted on your machine or in the cloud.
- **Human-like automation**. Grasp operates the browser just like a real human. You can even provide credentials for the agent to log in and retrieve personalized content.
- **Natural language control**. No code needed — simply describe what you want in plain language, and the agent will handle the rest.
Quick Start
> 🐳 **Before you start:**
> Make sure Docker is installed and running on your machine.
Run the following commands to pull and start Grasp:
- Pull the image
- Run the container
Replace YOUR_ANTHROPIC_KEY with your actual Anthropic API Key.
Once the container is running, open http://localhost:3000 in your browser to access the Grasp console.
Using other providers
You can use providers other than Anthropic.
To use a different provider, copy the .env.example file to .env and set the corresponding environment variables. Then run Grasp using .env file:
The supported providers are:
- Anthropic
- OpenAI
- Amazon Bedrock
- Azure OpenAI
Supporting more providers are working in progress. Free free to file an issue to request a new provider.
Enable secure auto-login
Grasp can automatically log in to websites for you. This makes it easier to retrieve personalized content or take actions on websites that require authentication. E.g. star a repo on GitHub, check in to a system, get your following list on X, etc.
The action to input your credentials is performed locally, and your password will **NOT** be sent to any LLM, so it's secure and safe.
To enable the auto-login:
- Copy the .credentials.example.yml file to .credentials.yml and fill in your credentials for each website.
- Create a browser-user-data directory to store the browser's user data. This will enable the persistent mode so you don't need to login again.
- Run Grasp by mounting the .credentials.yml file and browser-user-data directory.