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

# AppSignal para Python: Install

> Ferramenta de linha de comando para instalar o AppSignal em uma aplicação Python. Documentação sobre uso, opções e métodos de configuração.

export const VersionRequirements = ({versions = []}) => {
  if (!Array.isArray(versions) || versions.length === 0) {
    return null;
  }
  const boundaries = {
    upper: " or lower",
    exact: "",
    lower: " or higher"
  };
  const containerStyle = {
    marginTop: "0.5rem",
    marginBottom: "1.5rem"
  };
  const lineStyle = {
    display: "block",
    margin: "0 0 0.35rem 0",
    fontSize: "0.875rem",
    lineHeight: "1.4"
  };
  const pillBaseStyle = {
    display: "inline-block",
    padding: "0.1em 0.4em",
    borderRadius: "0.25rem",
    border: "1px solid",
    fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace",
    fontSize: "0.85em",
    fontWeight: 500
  };
  const pillColors = {
    "AppSignal for Elixir": {
      background: "#f3e8ff",
      borderColor: "#e9d5ff",
      color: "#9333ea"
    },
    "AppSignal for Front-end": {
      background: "#fef9c3",
      borderColor: "#fde68a",
      color: "#ca8a04"
    },
    "AppSignal for Go": {
      background: "#ccfbf1",
      borderColor: "#99f6e4",
      color: "#0d9488"
    },
    "AppSignal for JavaScript": {
      background: "#fef9c3",
      borderColor: "#fde68a",
      color: "#ca8a04"
    },
    "AppSignal for Node.js": {
      background: "#dcfce7",
      borderColor: "#bbf7d0",
      color: "#16a34a"
    },
    "AppSignal for Python": {
      background: "#dbeafe",
      borderColor: "#bfdbfe",
      color: "#2563eb"
    },
    "AppSignal for Ruby": {
      background: "#fee2e2",
      borderColor: "#fecaca",
      color: "#dc2626"
    },
    "AppSignal for Rust": {
      background: "#ffedd5",
      borderColor: "#fed7aa",
      color: "#ea580c"
    }
  };
  const defaultPillColor = {
    background: "#f4f4f5",
    borderColor: "#e4e4e7",
    color: "#52525b"
  };
  const getPillStyle = name => ({
    ...pillBaseStyle,
    ...pillColors[name] || defaultPillColor
  });
  const getBoundText = bound => {
    return boundaries[bound] || boundaries.lower;
  };
  return <div style={containerStyle}>
      {versions.map((v, i) => <p key={`${v.name}-${v.version}-${v.bound || "lower"}-${i}`} style={lineStyle}>
          This feature requires{" "}
          <code style={getPillStyle(v.name)}>{v.name}</code> version {v.version}
          {getBoundText(v.bound)}.
        </p>)}
    </div>;
};

<VersionRequirements
  versions={[
{ name: "AppSignal for Python", version: "0.1.0" }
]}
/>

A documentação informa tudo o que você precisa saber sobre como instalar o AppSignal através da ferramenta de linha de comando.

## Descrição

A ferramenta de linha de comando ajuda a configurar sua aplicação. A integração com aplicações Python pode exigir etapas adicionais, porque o instalador do AppSignal não sabe como sua aplicação está configurada. Recomendamos nosso [guia de instalação](/guides/new-application) ao adicionar uma nova aplicação ao AppSignal e seguir as etapas por framework em nossa [documentação de integrações](/python/instrumentations/).

Depois que a instalação for concluída, o [comando da ferramenta demo](/python/command-line/demo) é executado automaticamente para verificar se a instalação foi bem-sucedida. O comando da ferramenta demo envia dados de amostra da sua aplicação para os servidores do AppSignal, o que ajuda você a verificar se tudo está funcionando corretamente.

## Métodos de configuração

Há dois métodos de configuração fornecidos pelo instalador de linha de comando:

1. [Configuração via arquivo de configuração](#1-configuration-file)
2. [Configuração via variáveis de ambiente](#2-environment-variables).

### 1. Arquivo de configuração

O AppSignal pode ser configurado via um arquivo de configuração chamado `__appsignal__.py`, localizado no diretório raiz da sua aplicação. Ao escolher essa opção, nosso instalador gravará sua configuração nesse arquivo.

Ao configurar sua integração com o AppSignal através do arquivo de configuração, a Push API key que você fornecer ao instalador será gravada no arquivo de configuração `__appsignal__.py`. Não recomendamos adicionar essa chave a sistemas de controle de versão como Git, SVN ou Mercurial. Em vez disso, use a variável de ambiente `APPSIGNAL_PUSH_API_KEY` para armazenar sua API key.

Você pode ler mais sobre como configurar sua aplicação em nossa [documentação de configuração](/python/configuration).

### 2. Variáveis de ambiente

O AppSignal pode ser configurado através de variáveis de ambiente do sistema. Se você selecionar essa opção, nenhum [arquivo de configuração](#1-configuration-file) será gerado.

Você pode ler mais sobre como configurar sua aplicação em nossa [documentação de configuração](/python/configuration).

## Uso

Para instalar o appsignal via linha de comando, navegue até o diretório do seu projeto e execute o seguinte comando:

<CodeGroup>
  ```bash Bash theme={null}
  python -m appsignal install --push-api-key <Push API key>
  # For example
  python -m appsignal install --push-api-key 1234-1234-1234-1234
  ```
</CodeGroup>

A "Push API key" da sua aplicação será exibida no [assistente de instalação](https://appsignal.com/redirect-to/organization?to=sites/new) e também está disponível na seção de administração das configurações da sua organização, ou através [deste link](https://appsignal.com/redirect-to/organization?to=admin/api_keys).

## Opções disponíveis

| Opção          | Uso                                | Descrição                                                |
| -------------- | ---------------------------------- | -------------------------------------------------------- |
| `push-api-key` | `--push-api-key=<Push API key>`    | Define a Push API key usada para autenticar a aplicação. |
| `application`  | `--application=<application name>` | Define o nome da aplicação reportada.                    |