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

# Quickstart

> Deploying an agent in under 5 minutes.

## Install the Magma CLI

Our command line interface is the easiest way to create and deploy your agents. You only need to run this once.

```bash theme={null}
npm i -g @pompeii-labs/cli@latest
```

This will give you access to the `magma` command.

***

## Authentication

Next we need to log in to Magma. Don't worry, creating an account is absolutely free!

```bash theme={null}
magma login 
```

If you already created an account through the Magma dashboard, this will connect your CLI to your account. If you don't have an account yet, this will create one for you.

***

## Create your first agent

You can quickly create a new agent using the `init` command. This command will set up a template agent with basic starter code.

```bash theme={null}
magma init
```

The CLI will guide you through the process of creating your agent.

***

## Run your agent locally

Once you've initialized your agent, you can run it locally using the `run` command. This will open an interactive chat session in your terminal.

<Info>
  Look at the `.env` file in your project, and ensure you set the api key for the provider you are using.
</Info>

```bash theme={null}
magma run
```

Have a chat with your agent! When you're done, simply write `quit` to stop the chat.

***

## Deploy your agent

Once you've tested your agent locally and want to deploy it to production, you can use the `deploy` command:

```bash theme={null}
magma deploy
```

That's it! Your agent will be deployed and available to use in the dashboard.

***

When you are comfortable with the process of using the CLI, explore the [Magma Basics](/magma-framework/basics) to learn more about the different features and capabilities of Magma.

Also check out the [Development Guide](/get-started/development-guide) to learn how to develop and test more advanced features of your agents locally.

<CardGroup cols={2}>
  <Card title="Magma Basics" icon="volcano" href="/magma-framework/basics">
    Learn more about the different features and capabilities of Magma
  </Card>

  <Card title="Development Guide" icon="code" href="/get-started/development-guide">
    Learn how to develop and test more advanced features of your agents locally
  </Card>
</CardGroup>