# Virtual OS

## **Welcome to ToyStack Virtual OS Documentation**

#### **Build, Interact, and Deploy Desktop AI Agents**

**ToyStack Virtual OS** empowers developers to build and run **desktop AI agents** seamlessly within a virtualized operating system. With a focus on simplicity and performance, ToyStack provides a secure, scalable environment for your most demanding AI and automation workflows.

***

#### **What You Can Do with ToyStack Virtual OS**

* **Run Desktop AI Agents:** Launch and manage AI agents designed for desktop environments.
* **Streamlined Interactions:** Execute commands, manipulate UI elements, and capture real-time screenshots.
* **Seamless Integrations:** Connect with external AI tools like **Claude** for advanced functionality.
* **Ephemeral Environments:** Start and stop instances effortlessly, ensuring data privacy and security.

***

#### **Quickstart**

1. **Start an Instance:**\
   Begin your journey by launching a **ToyStack Virtual OS instance**. It's as simple as calling `instance.start()` in your workflow.
2. **Interact with the OS:**\
   Use built-in tools like `bash`, `computer`, `screenshot`, and `edit` to interact with the virtual environment programmatically.
3. **Build AI Agents:**\
   Leverage the power of ToyStack's virtualized OS to design and deploy AI-driven desktop agents.
4. **Integrate with Claude (Optional):**\
   Optionally connect ToyStack with **Claude** to enable computer-use actions and leverage cutting-edge AI capabilities.
5. **Stop the Instance:**\
   When you're done, stop the instance to securely end the session and delete all stored data.

***

#### **Why ToyStack Virtual OS?**

* **Secure:** Your data is isolated and protected in every session.
* **Scalable:** Easily manage multiple instances for development, testing, and production.
* **Developer-Friendly:** Tools and APIs designed with simplicity in mind.

***

#### **Upcoming Features**

Exciting features are in the pipeline! Soon, you'll be able to:

* Automate complex workflows with **desktop AI agents**.
* Enhance real-time interactions with additional tools and integrations.
* Access advanced analytics and monitoring for your instances.

***

***

**ToyStack Virtual OS** – The next step in developer-centric virtualization for AI and automation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toystack.ai/virtual-os.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.