---
id: allure-behave
version: "2.16.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# allure-behave — Allure behave integration

License: permissive · Maintenance: active · Downloads: 626.8K/mo

## What it is and what it does

Allure Behave is a formatter plugin that bridges Behave (a Python BDD framework) and Allure Report, capturing test execution data and converting it into Allure's structured report format. When you run Behave scenarios with this formatter, it generates JSON result files that Allure can then render into interactive HTML dashboards showing test outcomes, timings, attachments, and failure details.

The package works as a Behave formatter that you specify on the command line, or as a hook you call from your environment.py file for advanced scenarios like parallel test execution. It depends on behave for the test framework and allure-python-commons for the reporting infrastructure, making it a lightweight adapter rather than a standalone tool.

Use it for:

- Generate visual test reports from Behave scenarios for CI/CD pipelines and team dashboards.
- Track BDD test metrics and trends over time using Allure's built-in analytics.
- Attach screenshots, logs, or other artifacts to failed Behave scenarios for debugging.
- Integrate Behave test results into existing Allure Report infrastructure used by other test frameworks.
- Document test execution history and link scenarios to requirements or test cases.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Behave BDD test execution with Allure Report, generating detailed test reports and metrics from Behave scenarios.

Yes. Active maintenance, no security issues, low install friction, and a clear use case for teams already using Behave who want structured test reporting. The permissive Apache license poses no adoption barrier. Install if you run Behave scenarios and need Allure-compatible reports.

## Install

pip install allure-behave
uv add allure-behave
poetry add allure-behave

## Installing allure-behave

Before you install: Low install friction with a pure Python wheel and only two runtime dependencies (behave and allure-python-commons). Actively maintained with recent releases and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; you must retain license notices.

Quickstart:

pip install allure-behave
behave -f allure_behave.formatter:AllureFormatter -o ./allure_results ./features
allure serve ./allure_results

Requires Behave to be installed and feature files to exist; behave-parallel requires patching environment.py instead of using the formatter directly.

Verify before relying:

- Whether the package works with Python versions older than 3.8 despite no explicit requires_python constraint.
- Performance characteristics when handling large numbers of scenarios or parallel test runs.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 626.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

behave test reporting, allure behave integration, BDD test reports, behave formatter allure, test report generation, behave quality metrics, allure report adapter, bdd-testing, test-reporting, behave

[View on SkillFed](https://skillfed.io/packages/allure-behave) · [View on PyPI](https://pypi.org/project/allure-behave/)