# blackfire-python

Python

The `blackfire-python` command is being installed along with the Blackfire `pip` package. **It can be used to enable the Probe automatically when a profile is requested**, without modifying your code.

> **Note**
>
> No profile is triggered automatically with this command.

## Supported Frameworks

`blackfire-python` currently supports:

- Django
- Flask
- Odoo

## Usage with HTTP Servers

To ensure that your application listens to profile requests, you need to run your webserver through `blackfire-python` command.

Example with Django development server:

```bash
blackfire-python python manage.py runserver
```

Example with Django using `gunicorn`:

```bash
blackfire-python gunicorn myapp.wsgi
```

> **Caution**
>
> When using monitoring with the `uWSGI` server, ensure that the `--enable-threads`option is set. Without this, monitoring will not function correctly because Blackfire Monitoring relies on threads to communicate with the Blackfire Agent.

## Usage with CLI Commands

To be able to run CLI commands and profile them, you need to use `blackfire-python run` command:

```bash
blackfire-python run python my_command.py
```