praven-pro

Praven Pro Installation Guide

Quick Install

pip install praven-pro

With Optional Features

# Web interface
pip install praven-pro[web]

# Visualization
pip install praven-pro[viz]

# All features
pip install praven-pro[all]

From Source

git clone https://github.com/Ziforge/praven-pro.git
cd praven-pro
pip install -e .

Quick Start

Command Line

praven your_detections.csv \
  --lat 63.341 --lon 10.215 \
  --habitat wetland \
  --date 2025-10-13

Web Interface

praven-web
# Open http://localhost:5000 in your browser

Python API

from praven import BiologicalValidator, ValidationConfig

config = ValidationConfig(
    location=(63.341, 10.215),
    date="2025-10-13",
    habitat_type="wetland"
)

validator = BiologicalValidator(config)

result = validator.validate_detection(
    species="Lesser Spotted Woodpecker",
    timestamp="2025-10-13 23:45:00",
    confidence=0.85
)

print(result.status)  # "REJECT"
print(result.reason)  # "Nocturnal impossibility..."

Requirements

• Python 3.8+
• pandas >= 1.5.0
• numpy >= 1.20.0
• requests >= 2.25.0
• scikit-learn >= 1.0.0
• pydantic >= 2.0.0

Optional Requirements

• Flask >= 2.0.0 (for web interface)
• plotly >= 5.0.0 (for advanced visualizations)
• matplotlib >= 3.5.0 (for charts)

eBird API Key (Optional)

For enhanced geographic validation:

1. Register at https://ebird.org/api/keygen
2. Set environment variable: export EBIRD_API_KEY="your-key"

Without an API key, Praven will use cached data and offline validation rules.

Troubleshooting

ImportError: No module named ‘praven’

Make sure you installed the package:

pip install praven-pro

FileNotFoundError: species_db.json

The data files should be automatically included. If missing, reinstall:

pip uninstall praven-pro
pip install --no-cache-dir praven-pro

eBird API Rate Limiting

Praven automatically caches eBird data and refreshes it weekly. For large datasets, disable eBird preloading:

validator = BiologicalValidator(config, enable_ebird_preload=False)

Getting Help

• Documentation: https://github.com/Ziforge/praven-pro
• Issues: https://github.com/Ziforge/praven-pro/issues
• Examples: See examples/ directory

Updating

pip install --upgrade praven-pro

Uninstalling

pip uninstall praven-pro

This site is open source. Improve this page.