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

# Machines

**A machine is a real computer, and the one in front of you already counts.** It is where your agents actually run. Connect your own laptop and it costs nothing, or rent one from us and never think about it again.

## The two kinds you can have today

$$$Pillars items="computer|Your own computer|Free, for as long as you like. Install Simorg Desktop, sign in, name it; cloud|Simorg Runner|A cloud machine we run for you. Pick a size and it is ready" columns=2$$$

**Your own computer is free**, because it is your hardware. You do not create it from the panel; it registers itself when you sign into Simorg Desktop. The obvious caveat: an agent on your laptop stops when your laptop does.

A **Runner** takes a size and a card and is available immediately. Nothing to install, nothing to maintain, and it keeps working while your own computer is asleep.

GPU machines, rented servers and phones are named in the wizard and are not selectable yet.

$$$AlertBox type=WARNING title=A computer must be named to exist message=A machine that registers itself arrives with the name your operating system chose. Until you have said what it is, it stays out of your machine list and cannot be picked when you are giving an agent somewhere to run. Name it and it appears immediately.$$$

## Move an agent without reconfiguring it

An agent never holds a machine directly. It holds a **virtual machine**: a name, and a share of a real computer.

$$$SlotChain$$$

The agent knows about **Primary runner**. It has never heard of the laptop. Outgrow the laptop, buy a Runner, point the slot at it, and the agent carries on exactly as it was: same name, same slug, same settings, same conversations. It is the same idea as a phone number that follows you between handsets.

This is also why a row that reads **Not assigned** is not damage. The real machine went away and your agent's configuration survived it, which is precisely what the slot is for. Point it at something else and it runs again.

## One computer, several agents

One machine can host several agents at once, and it is worth doing. A machine running one small agent is mostly idle, and four small agents on one machine cost a quarter of what four machines cost.

Each slot gets its own share of CPU, memory and disk, and each of the three is a **range** rather than a number. The **guaranteed** amount is what this agent keeps when the machine is busy and nobody can squeeze it below. The **maximum** is how far it may climb when the machine is quiet, and it is the most this agent can ever take from the computer it is on.

$$$ResourceRange$$$

$$$AlertBox type=WARNING title=Memory is the ceiling to be generous with message=The three ceilings do not behave alike. A low CPU ceiling makes an agent slow, and a full disk makes it complain, but an agent that needs more memory than it was given is ended rather than slowed, because there is nowhere for the extra to go. Leave more room above the memory you expect to use than feels necessary.$$$

## Your machines stay yours

Machines never appear in the catalogue, neither the real ones nor the slots. They are your own infrastructure, not something published for other people to find.

There is also no token to paste anywhere. A Runner is ours to start, and your own computer connects by signing into Simorg Desktop as you, so you are never left holding a secret that connects as the machine.