# GPU compute your agent can use safely

Run commands from a local project on bounded remote GPUs while the agent and Git workflow stay local.

Canonical: https://docs.amics.ai/

<div className="docs-signal">
  <span>
    Local agent
  </span>

  <span aria-hidden="true">
    →
  </span>

  <span>
    Immutable source snapshot
  </span>

  <span aria-hidden="true">
    →
  </span>

  <span>
    Bounded GPU run
  </span>
</div>

Amics gives coding agents and developers the same provider-neutral command-line
interface to remote GPU compute. You approve a maximum price and runtime. Amics
snapshots the project, runs one literal command, streams its output, records the
result, and stops auto-acquired compute by default.

```bash
curl -fsSL https://downloads.amics.ai/cli/install.sh | sh
amics login
amics skill install
amics gpu options --min-vram 24 --max-runtime 30m

# Replace this placeholder with a family returned above, without spaces.
amics run \
  --gpu CHOSEN_GPU_IDENTIFIER --min-vram 24 \
  --max-hourly-price 1.50 --max-runtime 30m \
  -- nvidia-smi --query-gpu=name,memory.total --format=csv,noheader
```

## What you can do now [#what-you-can-do-now]

<Cards>
  <Card title="Run local projects" href="/cli/run">
    Execute training, evaluation, rendering, and batch commands on a remote GPU.
  </Card>

  <Card title="Delegate to an agent" href="/agents">
    Install the Amics skill so an agent follows the spend, secret, and lifecycle rules.
  </Card>

  <Card title="Reconnect to durable runs" href="/cli/runs">
    Follow logs, inspect an interrupted command, cancel it, or detach safely.
  </Card>
</Cards>

## The boundary [#the-boundary]

| Stays local                            | Goes to the remote run                                                |
| -------------------------------------- | --------------------------------------------------------------------- |
| Coding agent and chat history          | Selected project snapshot                                             |
| Git credentials and commits            | Literal command arguments                                             |
| Agent login and saved Amics credential | Environment values named with `--env`, including workload credentials |
| Source edits and experiment decisions  | Process stdout, stderr, and exit status                               |

Amics is not SSH, a remote desktop, a live filesystem mount, or a locally
attached CUDA device. It is bounded command execution with durable run state.

## Choose a path [#choose-a-path]

<Cards>
  <Card title="Five-minute quickstart" href="/getting-started/quickstart">
    Install, authenticate, check capacity, and run a first command.
  </Card>

  <Card title="Agent setup" href="/agents/install-skill">
    Give Codex, Claude Code, Cursor, or another compatible agent the Amics skill.
  </Card>

  <Card title="CLI overview" href="/reference/cli">
    See the command surface, output modes, and exit statuses.
  </Card>

  <Card title="HTTP API" href="/reference/endpoints">
    Integrate GPU options, snapshots, runs, and output directly.
  </Card>
</Cards>

## Documentation for agents [#documentation-for-agents]

Documentation pages are available as Markdown by appending `.md` to their URL
or requesting `Accept: text/markdown`. The homepage is [`/index.md`](/index.md).
Use [`/llms.txt`](/llms.txt) for the page index and [`/llms-full.txt`](/llms-full.txt)
for the complete corpus.