# Wheelmachine docs

> Machines for agents and people, by the second. Make one, run commands in it, copy files in and out, pause it and delete it, from a terminal, from Python or TypeScript, or from an agent.

Wheelmachine docs

Make a machine, usually in well under a second. Run commands in it, copy files in and out, pause it with its memory kept, and delete it when the work is done. From a terminal, from Python or TypeScript, or from an agent.

[Start the quickstart](https://docs.wheelmachine.ai/quickstart.html)[API reference](https://docs.wheelmachine.ai/reference.html)

Terminal:

```sh
$ wm machines create --name box
ID                            NAME  STATE    SIZE         LOCATION      AGE
m_01jb2xk3n4p5q6r7s8t9v0w1x2  box   running  2 CPU, 4 GB  Helsinki, FI  0s
$ wm exec box -- python3 -c "print(2+2)"
4
$ wm cp ./data.csv box:work/
$ wm machines pause box
ID                            NAME  STATE   SIZE         LOCATION      AGE
m_01jb2xk3n4p5q6r7s8t9v0w1x2  box   paused  2 CPU, 4 GB  Helsinki, FI  1m
```

## Four steps

1. **Get a key.** It begins `ak_live_` and holds the scopes it may use.
2. **Log in.** `wm login` keeps it on your computer, readable by you only.
3. **Make a machine.** 2, 4, 8 or 16 CPUs, with 2 GB of memory each.
4. **Use it.** Run commands, copy files, pause it, copy it, delete it.

## Where to go

[**Quickstart**A key, a machine, a command, a file, a pause. Five minutes.](https://docs.wheelmachine.ai/quickstart.html) [**Machines**States, sizes, sleeping when idle, copies and snapshots.](https://docs.wheelmachine.ai/machines.html) [**Commands and files**Run anything; copy files in and out.](https://docs.wheelmachine.ai/commands-and-files.html) [**Keys and scopes**What a key may do, and why one never makes a stronger one.](https://docs.wheelmachine.ai/keys.html) [**Command line**Every `wm` command and flag.](https://docs.wheelmachine.ai/cli.html) [**Libraries**Python and TypeScript, with retries that never make two.](https://docs.wheelmachine.ai/libraries.html) [**Agents**The `wm-mcp` server: machines as tools for an agent.](https://docs.wheelmachine.ai/agents.html) [**Errors**Every code the API answers with, and what to do.](https://docs.wheelmachine.ai/errors/index.html) [**API reference**Every route and field, made from the API's contract.](https://docs.wheelmachine.ai/reference.html)

> **For agents that read.** The whole site is one file at [llms-full.txt](https://docs.wheelmachine.ai/llms-full.txt), with an index at [llms.txt](https://docs.wheelmachine.ai/llms.txt); every page is also there as Markdown (the same address, ending `.md`), and the API's contract is [openapi.yaml](https://docs.wheelmachine.ai/openapi.yaml).