Quickstart
Get up and running with Cyberdesk in minutes.
Fastest Start: Cyberdesk Starter Assistant UI
The quickest way to get started with Cyberdesk is to use our AI SDK Starter template. This ready-to-use Next.js application demonstrates how to build an AI assistant with virtual desktop control capabilities using the Cyberdesk API and Anthropic's Claude AI model.
Features
- Interactive virtual desktop with streaming capabilities
- AI assistant chat interface powered by Claude 3.7 Sonnet
- Desktop control via AI (mouse clicks, keyboard input, screenshots)
- Bash command execution in the virtual environment
Quick Setup
- Clone the repository (alternatively, click "Use this template" on GitHub):
- Install dependencies:
- Create a
.env.local
file with your API keys:
- Start the development server:
- Open http://localhost:3000 in your browser
This template provides a complete working example that you can customize for your specific use case. For more details, check out the repository README.
Building a Custom Integration
If you want to build your own integration, you can use either the official TypeScript SDK or the official Python SDK. See the code tabs below for both options.
Prerequisites
- Node.js or Python 3.8+
- A Cyberdesk API key (obtain from your Cyberdesk dashboard)
Installation
1. Initialize the Client
2. Launch a Desktop Instance
3. Get Desktop Information (Including Stream URL)
4. Control the Desktop
Perform a Mouse Click
Run a Bash Command
5. Stop the Desktop Instance
6. Async Usage
7. Type Hints and Models
8. Available Computer Actions
Action | Factory Function (Python Only) | Description |
---|---|---|
Click Mouse | click_mouse | Mouse click at (x, y) |
Drag Mouse | drag_mouse | Mouse drag from/to (x, y) |
Move Mouse | move_mouse | Move mouse to (x, y) |
Scroll | scroll | Scroll by dx, dy |
Type Text | type_text | Type text |
Press Keys | press_keys | Press keyboard keys |
Screenshot | screenshot | Take a screenshot |
Wait | wait | Wait for ms milliseconds |
Get Cursor Pos | get_cursor_position | Get mouse cursor position |
Next Steps
- Explore the Tutorials for more complex examples using the SDK.
- Understand core concepts in the Conceptual Guide.
- Review the API Reference if you need details on the underlying REST API.