⚠️ Important: Warpsurf is an open source research project. Browser automation carries inherent risks. Monitor agents while they work and use capped API keys with spending limits. Use warpsurf at your own risk.
# Clone the repository
git clone https://github.com/warpsurf/warpsurf.git
cd warpsurf
# Install dependencies
pnpm install
# Build the extension
pnpm build:store
Then in Chrome:
After installation, click the warpsurf icon in your browser toolbar to open the side panel. Add your API keys in the Options page and select your preferred models.
Warpsurf supports several interaction modes:
| Feature | Description |
|---|---|
| 🔀 Router | Queries are automatically triaged to the right workflow |
| 🧠 Chat | Conversational interface powered by leading LLMs |
| 🔍 Search | Low latency search-grounded chat |
| 🤖 Agent | Navigates and interacts with any webpage |
| 🤖🤖 Multi-Agent | Orchestrate multiple agents for complex workflows |
| 📑 Tab Management | Agents operate using their own tab groups |
| 🔒 Privacy | Runs locally in your browser; your data stays with you |
| 👁️ Monitor | Watch agents work in real-time with tab streaming |
| 📈 Usage Tracking | Real-time token and cost statistics |
| 💰 Live Pricing | Accurate cost predictions with live pricing data |
| 🎮 Take Control | Agents pass control back to you at critical junctures |
| 📜 History | Optionally use browser history to improve performance |
| ⏱️ Task Estimation | Preview task duration and cost before starting |
Warpsurf is compatible with leading LLM providers:
These Chrome extensions can improve agent performance by reducing interruptions:
Warpsurf is an open source community project. Contributions are welcome!