> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viorant.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Run an agent locally

> Compose, test, and run an agent on your own machine.

Agents run **on your machine** — composed in your [Space](/concepts/spaces) and executed
locally, with output streamed back live as it runs.

<Steps>
  <Step title="Compose the agent">
    Open the agent in your Space to get the [Agent](/masters/agent) canvas, then bind a
    [Prompt](/masters/prompt), a [Model](/masters/model), and any
    [Skills](/masters/skill) it should use.
  </Step>

  <Step title="Give it a task">
    Open the test panel and enter the task or message for the agent.
  </Step>

  <Step title="Run and watch">
    Run the agent. Its steps and output stream back live, including the tools it
    calls along the way.
  </Step>
</Steps>

<Note>
  Everything here runs locally against your own keys. Running an agent **off your
  machine** — deploying it to Viorant Cloud — arrives with the 1.1 release.
</Note>