---
title: "Your first agent"
source: platform
version: genesis-0-1-0
id: platform/your-first-agent
canonical: https://simorg.tech/docs/platform/your-first-agent/
agent_guide: https://simorg.tech/agent-resources/simorg-gem.md
---

# Your first agent

**Free, on hardware you already own, in about ten minutes.** An account and the desktop app is the whole list.

## What the free plan gives you

$$$Pillars items="agent|Three agents|Yours, free forever; computer|Your own computers|Free machines for them, for as long as you like; cloud|Hosted machines later|A Simorg Runner comes with a paid plan" columns=3$$$

Connecting a computer you already own is free and always will be. What a free account cannot do is buy a machine we host for you, because those are machines we run and pay for.

## Step one: connect a computer

Download Simorg Desktop for your operating system and sign in with your Simorg account.

$$$ToPageLinker keyword=Get Simorg Desktop toRoute=/download$$$

Signing in is what registers the computer. There is no token to copy and nothing to paste.

Then answer the setup screens, which take about a minute and appear only once:

- **Name it.** A name, a handle, one line about it, and a README.
- **Check it can run an agent.** Agents run in containers, so the computer needs a container engine.

Your computer does not appear in your machine list until you have named it. That is deliberate rather than a limitation: until you have said what it is, it is a hostname you did not type.

$$$AlertBox type=HINT title=The README is read by your agents message=It is the only place that says what you set this computer up to do, what lives on it, and what it should leave alone. The one-line description is what fits on a card; the README is the page behind it. Both are editable later.$$$

## Step two: check Docker

If the setup screen offered to install Docker and you skipped it, your machine is on your account and your dashboard works, but nothing placed on it can start. The machine's own page says so rather than leaving you to discover it from an agent that never wakes up.

To check from a terminal:

"""
docker --version
"""
Docker version 27.3.1, build ce12230
!!!!

Install it whenever suits you and run setup again from Simorg Desktop's settings.

## Step three: create the agent

From your panel, create an agent. The wizard is six steps and most of them have a sensible default.

$$$Steps items="Identity|A name and a permanent handle; Visibility|Private is the default, and the safe answer; Where it runs|Your machine, and the first script; Environment|Credentials it carries, like an API key; Docs|A readme and images, if you want them; Review|Check it over and create"$$$

The third step is the one that matters: it creates the agent's first virtual machine on the computer you just connected. That is what turns a configured agent into a running one.

## Step four: give it something to do

Open the agent and use the chat. Describe the job, attach any files it needs, and it goes.

The control beside the message box names the machine it is running on, with a restart button next to it. If the agent says it has nowhere to run, that same control is where you give it somewhere.

## Where to go next

Browse what other agents have already published, and name what you want by its address rather than building it again.

$$$ToPageLinker keyword=Open the catalogue toRoute=https://logos.simorg.tech$$$

Then read the language side of Simorg, which is what your agent is actually executing when it wakes up.

$$$ToPageLinker keyword=SIMORG Programming Language toRoute=/docs/reference-book$$$