Lightcone Documentation
One API to get any piece of work done. Build AI agents that see, think, and act on browsers and desktops.
Lightcone is a cloud platform for browser automation and AI agents. Create sandboxed browser sessions, run autonomous agents that see and act on web pages, or build your own computer-use agent (CUA) loop — all through a single API. No browser infrastructure to manage.
Get started
Section titled “Get started”| Quickstart | Go from zero to a working browser session in under 5 minutes |
| Authentication | Get your API key and configure the SDK |
| How Lightcone works | Architecture, session lifecycle, and the three API layers |
| API Reference | Full reference for all 46 endpoints |
Choose your path
Section titled “Choose your path”I want to automate browsers programmatically
Section titled “I want to automate browsers programmatically”Create a cloud browser session and control it with clicks, typing, navigation, and screenshots. Full Chromium with stealth mode and proxy support.
- Computers overview — sessions, lifecycle, and all available actions
- Automate a browser — end-to-end walkthrough
- Manage browser tabs — multi-tab workflows
I want AI agents to complete tasks for me
Section titled “I want AI agents to complete tasks for me”Give an instruction in natural language and let an autonomous agent drive a browser to complete it. Stream progress in real time.
- Agent Tasks — start, monitor, pause, resume agents
- Run an AI agent — streaming, polling, and steering
I want to build my own computer-use agent
Section titled “I want to build my own computer-use agent”Use the OpenAI-compatible Responses API to build a multi-turn computer-use agent (CUA) loop. You control the agent at every step: the model decides what to click, you execute it, and feed back a screenshot.
- Responses API — create responses, process actions, chain turns
- Computer-use agent loop — full implementation guide
I want text generation / Chat Completions
Section titled “I want text generation / Chat Completions”OpenAI-compatible Chat Completions with tool calling, streaming, and structured outputs. Drop-in replacement — just change the base URL.
- Chat Completions — usage, streaming, tool calling, models
Real-world use cases
Section titled “Real-world use cases”| Use case | What it does |
|---|---|
| Web scraping | Extract structured data from any website, even behind logins and bot detection |
| Form automation | Fill and submit multi-step forms across legacy web apps without APIs |
| Dashboard monitoring | Watch web dashboards for changes and trigger alerts |
Integrations
Section titled “Integrations”Lightcone works with the tools you already use. Connect to agent frameworks, orchestration platforms, and AI providers.
| LangChain | OpenAI CUA | Anthropic Claude |
| CrewAI | Browser-Use | Vercel AI SDK |
| MCP Server | Playwright | Mastra |
Install the SDK
Section titled “Install the SDK”pip install tzafonnpm install @tzafon/lightconeHaving trouble? See the Troubleshooting guide.