Quickstart

This guide takes you from a new Testinel project to your first uploaded pytest run.

Prerequisites

• Python 3.10 or later
• A pytest test suite
• A Testinel account

1. Create a project

Create a project in Testinel, then copy its TESTINEL_DSN. The DSN authorizes test-result submission, so treat it as a secret and do not commit it to your repository.

2. Install the reporter

python -m pip install --upgrade pytest-testinel

For a uv-managed project:

uv add --dev pytest-testinel

3. Set the project DSN

export TESTINEL_DSN="https://testinel.dev/ingest/your-project-dsn/"

Use the exact value copied from your Testinel project.

4. Run the tests

pytest --showlocals --tb=long -vv

The reporter sends the run and its test results while pytest executes. Open the project in Testinel to inspect the completed run and any failures.

Next step

Store TESTINEL_DSN in your CI provider’s secret store and expose it only to the test job. For browser tests, retain failure artifacts so Testinel can show screenshots, videos, and Playwright traces alongside the traceback.