> ## 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 pour Python : Install

> Outil en ligne de commande pour installer AppSignal dans une application Python. Documentation sur l'utilisation, les options et les méthodes de configuration.

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" }
]}
/>

Cette documentation vous indique tout ce que vous devez savoir sur l'installation d'AppSignal via l'outil en ligne de commande.

## Description

L'outil en ligne de commande aide à la mise en place de la configuration pour votre application. L'intégration avec les applications Python peut nécessiter des étapes supplémentaires, car l'installateur AppSignal ne connaît pas la façon dont votre application est configurée. Nous vous recommandons notre [guide d'installation](/guides/new-application) lors de l'ajout d'une nouvelle application à AppSignal et de suivre les étapes par framework dans notre [documentation des intégrations](/python/instrumentations/).

Une fois l'installation terminée, la [commande de l'outil demo](/python/command-line/demo) est exécutée automatiquement pour vérifier que l'installation s'est déroulée avec succès. La commande de l'outil demo envoie des données d'exemple depuis votre application vers les serveurs AppSignal, ce qui vous aide à vérifier que tout fonctionne correctement.

## Méthodes de configuration

L'installateur en ligne de commande propose deux méthodes de configuration :

1. [Configuration via un fichier de configuration](#1-configuration-file)
2. [Configuration via des variables d'environnement](#2-environment-variables).

### 1. Fichier de configuration

AppSignal peut être configuré via un fichier de configuration appelé `__appsignal__.py`, situé dans le répertoire racine de votre application. Lorsque vous choisissez cette option, notre installateur écrira votre configuration dans ce fichier.

Lorsque vous configurez votre intégration AppSignal via le fichier de configuration, la clé Push API que vous fournissez à l'installateur sera écrite dans le fichier de configuration `__appsignal__.py`. Nous ne recommandons pas d'ajouter cette clé à des systèmes de contrôle de version tels que Git, SVN ou Mercurial. Utilisez plutôt la variable d'environnement `APPSIGNAL_PUSH_API_KEY` pour stocker votre clé API.

Vous pouvez en savoir plus sur la configuration de votre application dans notre [documentation sur la configuration](/python/configuration).

### 2. Variables d'environnement

AppSignal peut être configuré via les variables d'environnement système. Si vous sélectionnez cette option, aucun [fichier de configuration](#1-configuration-file) ne sera généré.

Vous pouvez en savoir plus sur la configuration de votre application dans notre [documentation sur la configuration](/python/configuration).

## Utilisation

Pour installer appsignal via la ligne de commande, accédez au répertoire de votre projet et exécutez la commande suivante :

<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>

La « Push API key » de votre application sera affichée dans l'[assistant d'installation](https://appsignal.com/redirect-to/organization?to=sites/new) et est également disponible dans la section d'administration des paramètres de votre organisation, ou via [ce lien](https://appsignal.com/redirect-to/organization?to=admin/api_keys).

## Options disponibles

| Option         | Utilisation                        | Description                                                       |
| -------------- | ---------------------------------- | ----------------------------------------------------------------- |
| `push-api-key` | `--push-api-key=<Push API key>`    | Définit la clé Push API utilisée pour authentifier l'application. |
| `application`  | `--application=<application name>` | Définit le nom de l'application signalée.                         |