Reporting Issues

Found a bug or have a feature idea? Here's how to let us know.

🐛 Bug Reports

Use our structured bug report form to ensure we can reproduce and fix the issue quickly:

Field	Required	Example
Description	✅	"PDF extraction returns empty entities for scanned documents"
Steps to reproduce	✅	Minimal code snippet or API calls to trigger the bug
Expected behaviour	✅	"Should return 5 extracted entities"
Actual behaviour	✅	"Returns empty list with no error"
Purple8 version	✅	0.7.0 — check with `pip show purple8-docintel`
Python version	✅	3.11.9 — check with `python --version`
OS	✅	macOS 15.2, Ubuntu 22.04, etc.
Installation method	✅	pip install / Docker / source
Logs / stack traces	Optional	Paste any error output

Minimal reproduction — strip your code down to the smallest example that triggers the bug
Include the full stack trace — don't truncate error messages

Check your version — make sure you're on the latest release before reporting:

bash

pip install --upgrade "purple8-docintel @ git+ssh://git@github.com/Purple8-Technologies/Purple8-DocIntel.git@main"

Search existing issues — someone may have already reported it: Search issues

Have an idea for a new feature or improvement? We'd love to hear it:

Field	Required	Example
Problem / motivation	✅	What problem does this solve? Why do you need it?
Proposed solution	✅	How you'd like it to work (API examples welcome)
Alternatives considered	Optional	Workarounds you've tried
Area	✅	Which part of DocIntel this relates to

Our issue template includes these categories:

Do not open a public issue for security vulnerabilities.

Report them privately to security@purple8.ai. See the full Security Policy for details on our responsible disclosure process and response timeline.