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 methodsDetection model adaptersDashboard enhancementsDocumentation improvementsExample notebooksPerformance optimizationsBug fixes

Colab NotebooksComing Soon

Interactive notebooks are being prepared. Once published, they will be directly runnable on Google Colab.

Classification Demo

Soon

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

Detection Demo

Soon

Object detection with Faster R-CNN, mAP metrics, and bbox-aware augmentations.

Augmentations Guide

Soon

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

Custom Data

Soon

Bring your own images using ImageFolder or YOLO format.