surf  by e2b-dev

AI agent for virtual desktop interaction via natural language

created 4 months ago
497 stars

Top 63.3% on sourcepulse

GitHubView on GitHub
Project Summary

Surf is an AI-powered computer use agent that allows users to interact with a virtual desktop environment through natural language. It targets developers and power users who want to automate tasks or explore AI capabilities on a simulated computer. The primary benefit is enabling complex, multi-step computer operations via simple chat commands.

How It Works

Surf leverages a Next.js frontend to provide a chat interface and a view of a virtual desktop. It integrates with E2B's cloud-based sandbox environment to create isolated Linux desktops. User instructions are processed by OpenAI's API, which translates natural language into executable actions (e.g., clicks, typing) within the sandbox. Actions and AI responses are streamed back to the user in real-time via Server-Sent Events for a dynamic experience.

Quick Start & Requirements

  • Install dependencies: npm install
  • Environment variables: Requires E2B_API_KEY and OPENAI_API_KEY in .env.local.
  • Start server: npm run dev
  • Access: http://localhost:3000
  • Prerequisites: Node.js, npm, E2B API key, OpenAI API key.
  • Documentation: E2B Documentation
  • Community: E2B Discord

Highlighted Details

  • Real-time streaming of AI actions and responses.
  • Utilizes OpenAI API for natural language understanding and action generation.
  • Provides a virtual Linux desktop environment via E2B sandboxes.
  • Includes example prompts and a chat interface for interaction.

Maintenance & Community

The project is maintained by e2b-dev. Support is available via their Discord server.

Licensing & Compatibility

  • License: Apache License 2.0.
  • Compatibility: Permissive license suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

The application relies on external API keys for E2B and OpenAI, incurring costs. Sandbox instances have a limited timeout, though they can be extended.

Health Check
Last commit

1 week ago

Responsiveness

1+ week

Pull Requests (30d)
1
Issues (30d)
1
Star History
152 stars in the last 90 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), Taranjeet Singh Taranjeet Singh(Cofounder of Mem0), and
1 more.

fragments by e2b-dev

0.6%
6k
Next.js template for AI-generated apps
created 1 year ago
updated 1 week ago
Feedback? Help us improve.