Community

BNNR is open-source and community-driven. Get involved, contribute, or just say hello.

Connect

GitHub Repository

Star the repo, browse source code, and track releases.

View Repository

Discussions

Ask questions, share ideas, and connect with other users.

Join Discussions

Report a Bug

Found a bug? Open an issue with reproduction steps.

Report Bug

Feature Request

Have an idea for a new feature or improvement?

Request Feature

Contributing

We welcome contributions of all sizes. Here is how to get started:

Development Setup

# Clone the repository
git clone https://github.com/bnnr-team/bnnr.git
cd bnnr

# Install in editable mode with dev dependencies
pip install -e ".[dev,dashboard,gpu]"

# Run tests
pytest tests/ -v

# Run linting
ruff check src/
mypy src/bnnr/

Pull Request Guidelines

Fork the repo and create a feature branch

Write tests for new functionality

Ensure all tests pass before submitting

Follow the existing code style

Update documentation for API changes

Keep PRs focused and well-scoped

Areas for Contribution

New augmentationsAdditional XAI methodsModel adapter integrationsDashboard enhancementsDocumentation improvementsExample notebooksPerformance optimizationsBug fixes

Colab Notebooks

Run BNNR directly in Google Colab — no local setup required.

Classification Demo

Full BNNR pipeline on STL-10 with XAI explainability and live dashboard.

Augmentations Guide

Visual walkthrough of every BNNR augmentation with ICD/AICD deep-dive.

Custom Data

Bring your own images using an ImageFolder-style layout.

Detection Demo

YOLOv8 on COCO128 with bbox-aware augmentations, mAP metrics, and detection XAI (use bnnr ≥ 0.2.6 from PyPI).