Skip to content

Installation

Install OracleTrace in under a minute and get ready to trace Python performance regressions.

Requirements

  • Python 3.10+
  • pip

Standard install

pip install oracletrace

Verify install

oracletrace --help

You should see command usage, required target script, and available options.

python -m venv .venv

Activate it:

source .venv/bin/activate

.venv\Scripts\Activate.ps1

Then install:

pip install oracletrace

Upgrade to latest version

pip install --upgrade oracletrace

Dependency note

OracleTrace uses rich for readable terminal output and installs it automatically.

Troubleshooting

oracletrace command not found

Try running with Python module mode:

python -m oracletrace --help

If that works, your scripts directory is probably missing from PATH.

Python version error

Check your Python version:

python --version

OracleTrace requires Python 3.10 or newer.