canns 0.15.1__tar.gz → 1.0.1__tar.gz

{canns-0.15.1 → canns-1.0.1}/.gitignore

@@ -186,6 +186,7 @@ cython_debug/
 *.npy
 *.png
 !docs/_static/*.png
+!docs/_static/*.gif
 /.ref
 
 # Model checkpoints

{canns-0.15.1 → canns-1.0.1}/CHANGELOG.md

@@ -5,6 +5,56 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-02-06
+
+### Added
+- CLI module (`src/canns/__main__.py`) for command-line interface support
+- Comprehensive test coverage for CLI, lazy imports, data loaders, and utilities
+- Integration tests for pipeline launcher
+- Unit tests for task base classes and benchmarking utilities
+- 1D CANN smooth-tracking example in documentation
+
+### Changed
+- Restructured test suite into `unit/` and `integration/` directories (PR #96)
+- Optimized CI pipeline for faster test execution (PR #96)
+- Relocated documentation images from `images/` to `docs/_static/`
+- Updated status badge to "stable" and maintenance year to 2026
+- Enhanced installation instructions with accelerator options (cuda12, cuda13, tpu, gui)
+- Expanded architecture diagram caption with five-layer hierarchy description
+- Normalized pip install examples by removing unnecessary quotes
+- Updated documentation URL to https://routhleck.com/canns
+- Added Zenodo DOI badge for v1.0.0 release
+- Updated citation information with expanded author list and affiliations
+
+### Fixed
+- Improved test organization and maintainability
+- Updated all documentation image references to new paths
+
+## [1.0.0] - 2026-02-02
+
+### Added
+- Architecture diagram (`docs/_static/architecture.png`) explaining modular design principles
+- Comprehensive analyzer visualization showcase (`docs/_static/analyzer-display.png`, 4.7MB)
+- ASA GUI preview animation (`docs/_static/asa-gui.gif`, 898KB)
+
+### Changed
+- **Production Ready Milestone**: v1.0.0 marks API stability and production readiness
+- Complete README restructure (both English and Chinese) with improved project overview
+- Enhanced Quick Start example with better comments and complete workflow demonstration
+- Updated status badge from "beta" to "stable" in README.md and README_zh.md
+- Improved visual gallery presentation with richer analyzer capability showcase
+- Reorganized README sections: Overview, Architecture, Core Features, Analyzer Visuals, Quick Start
+
+## [0.15.1] - 2026-02-01
+
+### Changed
+- Refactored ASA module: removed legacy aliases and consolidated utilities (PR #95)
+- Replaced custom Gaussian filter with scipy public API
+- Added comprehensive docstrings to key private functions
+
+### Fixed
+- Reduced PyPI package size by excluding unnecessary files
+
 ## [0.15.0] - 2026-01-31
 
 ### Added
@@ -210,7 +260,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Comprehensive plotting functions for ASA analysis types
 - New example scripts: cohomap.py, cohospace.py, firing_field_map.py, path_compare.py, tda_vis.py
 - Research paper draft (paper.md) with comprehensive bibliography (paper.bib)
-- Architecture diagram (images/architecture.png)
+- Architecture diagram (docs/_static/architecture.png)
 - GitHub Actions workflow for draft PDF generation
 - CLI entry point for ASA TUI: `python -m canns.pipeline.asa`
 - Image preview and external viewer support in TUI
@@ -577,6 +627,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Basic structure template
 - Core application structure
 
+[1.0.1]: https://github.com/routhleck/canns/compare/v1.0.0...v1.0.1
+[1.0.0]: https://github.com/routhleck/canns/compare/v0.15.1...v1.0.0
+[0.15.1]: https://github.com/routhleck/canns/compare/v0.15.0...v0.15.1
 [0.15.0]: https://github.com/routhleck/canns/compare/v0.14.3...v0.15.0
 [0.14.3]: https://github.com/routhleck/canns/compare/v0.14.2...v0.14.3
 [0.14.2]: https://github.com/routhleck/canns/compare/v0.14.1...v0.14.2
@@ -615,4 +668,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.4.0]: https://github.com/routhleck/canns/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/routhleck/canns/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/routhleck/canns/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/routhleck/canns/releases/tag/v0.1.0
+[0.1.0]: https://github.com/routhleck/canns/releases/tag/v0.1.0

canns-1.0.1/CITATION.cff

@@ -0,0 +1,139 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+type: software
+title: "CANNs: Continuous Attractor Neural Networks Toolkit"
+authors:
+  - family-names: "He"
+    given-names: "Sichao"
+    email: "sichaohe@outlook.com"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+    orcid: "https://orcid.org/0009-0009-4564-1753"
+  - family-names: "Tuerhong"
+    given-names: "Aiersi"
+    affiliation: "College of Mathematics and Statistics, Chongqing University"
+    orcid: "https://orcid.org/0009-0006-4603-4734"
+  - family-names: "She"
+    given-names: "Shangjun"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+    orcid: "https://orcid.org/0009-0008-4490-7612"
+  - family-names: "Chu"
+    given-names: "Tianhao"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+    orcid: "https://orcid.org/0000-0001-9910-9361"
+  - family-names: "Wu"
+    given-names: "Yuling"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+    orcid: "https://orcid.org/0009-0001-5303-5413"
+  - family-names: "Zuo"
+    given-names: "Junfeng"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+  - family-names: "Wu"
+    given-names: "Si"
+    affiliation:
+      - "School of Psychological and Cognitive Sciences, Peking University"
+      - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+      - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+      - "Center of Quantitative Biology, Peking University"
+    orcid: "https://orcid.org/0000-0001-9650-6935"
+repository-code: "https://github.com/Routhleck/canns"
+url: "https://routhleck.com/canns"
+abstract: "A research toolkit built on BrainPy and JAX that bundles model collections, task generators, analyzers, and the ASA pipeline (GUI/TUI) so researchers can run simulations and analyze results in a consistent workflow."
+keywords:
+  - continuous attractor neural networks
+  - CANNs
+  - computational neuroscience
+  - spatial cognition
+  - neural dynamics
+  - JAX
+  - brain-inspired computing
+license: Apache-2.0
+version: "v1.0.0"
+date-released: "2026-02-02"
+identifiers:
+  - type: doi
+    value: "10.5281/zenodo.18453893"
+    description: "The versioned DOI for version v1.0.0"
+  - type: doi
+    value: "10.5281/zenodo.17412545"
+    description: "The concept DOI (always resolves to latest version)"
+preferred-citation:
+  type: software
+  title: "CANNs: Continuous Attractor Neural Networks Toolkit"
+  authors:
+    - family-names: "He"
+      given-names: "Sichao"
+      email: "sichaohe@outlook.com"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+      orcid: "https://orcid.org/0009-0009-4564-1753"
+    - family-names: "Tuerhong"
+      given-names: "Aiersi"
+      affiliation: "College of Mathematics and Statistics, Chongqing University"
+      orcid: "https://orcid.org/0009-0006-4603-4734"
+    - family-names: "She"
+      given-names: "Shangjun"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+      orcid: "https://orcid.org/0009-0008-4490-7612"
+    - family-names: "Chu"
+      given-names: "Tianhao"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+      orcid: "https://orcid.org/0000-0001-9910-9361"
+    - family-names: "Wu"
+      given-names: "Yuling"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+      orcid: "https://orcid.org/0009-0001-5303-5413"
+    - family-names: "Zuo"
+      given-names: "Junfeng"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+    - family-names: "Wu"
+      given-names: "Si"
+      affiliation:
+        - "School of Psychological and Cognitive Sciences, Peking University"
+        - "Peking-Tsinghua Center for Life Sciences, Academy for Advanced Interdisciplinary Studies, Peking University"
+        - "PKU-IDG/McGovern Institute for Brain Research, Peking University"
+        - "Center of Quantitative Biology, Peking University"
+      orcid: "https://orcid.org/0000-0001-9650-6935"
+  doi: "10.5281/zenodo.18453893"
+  url: "https://github.com/Routhleck/canns"
+  version: "v1.0.0"
+  year: 2026
+  month: 2

canns-1.0.1/PKG-INFO

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: canns
+Version: 1.0.1
+Summary: A Python Library for Continuous Attractor Neural Networks
+Project-URL: Repository, https://github.com/routhleck/canns
+Author-email: Sichao He <sichaohe@outlook.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: <4.0,>=3.11
+Requires-Dist: brainpy[cpu]
+Requires-Dist: canns-lib>=0.6.2
+Requires-Dist: climage>=0.2.2
+Requires-Dist: furo>=2025.7.19
+Requires-Dist: h5py>=3.7
+Requires-Dist: igraph>=1.0.0
+Requires-Dist: imageio[ffmpeg]>=2.37.0
+Requires-Dist: leidenalg>=0.11.0
+Requires-Dist: matplotlib>=3.5
+Requires-Dist: notebook>=7.4.4
+Requires-Dist: numba>=0.56.0
+Requires-Dist: numpy<2.3,>=1.24
+Requires-Dist: scikit-image>=0.19
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: textual>=7.3.0
+Requires-Dist: tqdm
+Provides-Extra: cpu
+Requires-Dist: brainpy[cpu]; extra == 'cpu'
+Provides-Extra: cuda12
+Requires-Dist: brainpy[cuda12]; (platform_system == 'Linux') and extra == 'cuda12'
+Provides-Extra: cuda13
+Requires-Dist: brainpy[cuda13]; (platform_system == 'Linux') and extra == 'cuda13'
+Provides-Extra: gui
+Requires-Dist: imageio; extra == 'gui'
+Requires-Dist: pillow; extra == 'gui'
+Requires-Dist: pyside6>=6.6.0; extra == 'gui'
+Requires-Dist: qtawesome; extra == 'gui'
+Requires-Dist: requests>=2.31.0; extra == 'gui'
+Provides-Extra: tpu
+Requires-Dist: brainpy[tpu]; (platform_system == 'Linux') and extra == 'tpu'
+Description-Content-Type: text/markdown
+
+# CANNs: Continuous Attractor Neural Networks Toolkit
+
+<div align="center">
+  <img src="images/logo.svg" alt="CANNs Logo" width="350">
+</div>
+
+[<img src="https://badges.ws/badge/status-stable-green" />](https://github.com/routhleck/canns)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/canns)
+[<img src="https://badges.ws/maintenance/yes/2026" />](https://github.com/routhleck/canns)
+<picture><img src="https://badges.ws/github/release/routhleck/canns" /></picture>
+<picture><img src="https://badges.ws/github/license/routhleck/canns" /></picture>
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18453893.svg)](https://doi.org/10.5281/zenodo.18453893)
+
+
+<picture><img src="https://badges.ws/github/stars/routhleck/canns?logo=github" /></picture>
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/canns?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/canns)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Routhleck/canns)
+[<img src="https://badges.ws/badge/Buy_Me_a_Coffee-ff813f?icon=buymeacoffee" />](https://buymeacoffee.com/forrestcai6)
+
+> 中文说明请见 [README_zh.md](README_zh.md)
+
+## Overview
+
+CANNs (Continuous Attractor Neural Networks toolkit) is a research toolkit built on [BrainPy](https://github.com/brainpy/BrainPy) and [JAX](https://github.com/jax-ml/jax), with optional Rust-accelerated [`canns-lib`](https://github.com/Routhleck/canns-lib) for selected performance-critical routines (e.g., TDA/Ripser and task generation). It bundles model collections, task generators, analyzers, and the ASA pipeline (GUI/TUI) so researchers can run simulations and analyze results in a consistent workflow. The API separates models, tasks, analyzers, and trainers to keep experiments modular and extensible.
+
+## Architecture
+
+<p align="center">
+  <img src="docs/_static/architecture.png" alt="CANNs Architecture" width="900">
+  <br>
+  <span style="color: grey; font-size: 14px;">Layer hierarchy of the CANNs library showing five levels: Application (Pipeline orchestration), Functional (Task, Trainer, Analyzer, Utils modules), Core Models (CANN implementations), Foundation (BrainPy/JAX and Rust FFI backends), and Hardware (CPU/GPU/TPU support)</span>
+</p>
+
+The CANNs library follows a modular architecture guided by two core principles: **separation of concerns** and **extensibility through
+base classes**. The design separates functional responsibilities into five independent modules: 
+1. **Models** (`canns.models`) define neural network dynamics; 
+2. **Tasks** (`canns.task`) generate experimental paradigms and input data; 
+3. **Analyzers** (`canns.analyzer`) provide visualization and analysis tools;
+4. **Trainers** (`canns.trainer`) implement learning rules for brain-inspired models; 
+5. **Pipeline** (`canns.pipeline`) orchestrates complete workflows.
+
+Each module focuses on a single responsibility—models don't generate input data, tasks don't analyze results, and analyzers don't modify
+parameters. This separation ensures maintainability, testability, and extensibility. All major components inherit from abstract base classes
+(`BasicModel`, `BrainInspiredModel`, `Trainer`) that define standard interfaces, enabling users to create custom implementations that
+seamlessly integrate with the built-in ecosystem.
+
+## Core Features
+
+
+
+- **Model collections**: basic CANNs (1D/2D, SFA), hierarchical path integration, theta-sweep models, brain-inspired models (e.g., Amari-Hopfield, linear/spiking layers)
+- **Task generators**: smooth tracking, population coding, template matching, open/closed-loop navigation
+- **Analyzer suite**: energy landscapes, tuning curves, raster/firing-rate plots, TDA and decoding utilities, cell classification
+- **ASA pipeline & GUI/TUI**: end-to-end workflow for preprocessing, TDA, decoding, and result visualization (e.g., CohoMap/CohoSpace/PathCompare/FR/FRM/GridScore)
+- **Training & extensibility**: HebbianTrainer plus base classes for consistent extension
+- **Optional acceleration**: `canns-lib` for selected performance-critical routines
+
+## Analyzer Visuals
+
+<p align="center">
+  <img src="docs/_static/figure2_full.png" alt="Model Analysis Overview" width="900">
+  <br>
+  <span style="color: grey; font-size: 14px;">Overview of Neural Dynamics Models. Comparison of three basic models: (A) 1D CANN, (B) 2D CANN, and (C) Grid Cell Network</span>
+</p>
+
+<p align="center">
+  <img src="docs/_static/analyzer-display.png" alt="Analyzer Display" width="900">
+  <br>
+  <span style="color: grey; font-size: 14px;">Rich Analyzer Visualization Results</span>
+</p>
+<p align="center">
+  <img src="docs/_static/asa-gui.gif" alt="ASA GUI Preview" width="720">
+  <br>
+  <span style="color: grey; font-size: 14px;">ASA GUI preview</span>
+</p>
+<p align="center">
+  <a href="https://youtu.be/OoEo5Qa9f7M">
+    <img src="https://img.youtube.com/vi/OoEo5Qa9f7M/hqdefault.jpg" alt="ASA GUI Demo (YouTube)" width="720">
+  </a>
+  <br>
+  <span style="color: grey; font-size: 14px;">ASA GUI demo video</span>
+</p>
+
+<div align="center">
+<table>
+<tr>
+<td align="center" width="50%" valign="top">
+<h4>Smooth Tracking 1D</h4>
+<img src="docs/_static/smooth_tracking_1d.gif" alt="Smooth Tracking 1D" width="320">
+<br><em>Activity bump following a moving stimulus</em>
+</td>
+<td align="center" width="50%" valign="top">
+<h4>CANN2D Encoding</h4>
+<img src="docs/_static/CANN2D_encoding.gif" alt="CANN2D Encoding" width="320">
+<br><em>2D population encoding patterns over time</em>
+</td>
+</tr>
+<tr>
+<td colspan="2" align="center">
+<h4>Theta Sweep Animation</h4>
+<img src="docs/_static/theta_sweep_animation.gif" alt="Theta Sweep Animation" width="600">
+<br><em>Theta-modulated sweep dynamics</em>
+</td>
+</tr>
+<tr>
+<td align="center" width="50%" valign="top">
+<h4>Bump Analysis</h4>
+<img src="docs/_static/bump_analysis_demo.gif" alt="Bump Analysis Demo" width="320">
+<br><em>Bump fitting and stability diagnostics</em>
+</td>
+<td align="center" width="50%" valign="top">
+<h4>Torus Bump</h4>
+<img src="docs/_static/torus_bump.gif" alt="Torus Bump" width="320">
+<br><em>Bump dynamics projected onto a torus manifold</em>
+</td>
+</tr>
+</table>
+</div>
+
+## Quick Start
+
+1D CANN smooth tracking (imports → simulation → visualization)
+
+```python
+import brainpy.math as bm
+from canns.analyzer.visualization import PlotConfigs, energy_landscape_1d_animation
+from canns.models.basic import CANN1D
+from canns.task.tracking import SmoothTracking1D
+
+# simulation time step
+bm.set_dt(0.1)
+
+# build model
+cann = CANN1D(num=512)
+
+# build tracking task (Iext length = duration length + 1)
+task = SmoothTracking1D(
+    cann_instance=cann,
+    Iext=(0.0, 0.5, 1.0, 1.5),
+    duration=(5.0, 5.0, 5.0),
+    time_step=bm.get_dt(),
+)
+task.get_data()
+
+
+# one-step simulation callback
+def step(t, stimulus):
+    cann(stimulus)
+    return cann.u.value, cann.inp.value
+
+
+# run simulation loop
+us, inputs = bm.for_loop(
+    step,
+    operands=(task.run_steps, task.data),
+)
+
+# visualize with energy landscape animation
+config = PlotConfigs.energy_landscape_1d_animation(
+    time_steps_per_second=int(1 / bm.get_dt()),
+    fps=20,
+    title="Smooth Tracking 1D",
+    xlabel="State",
+    ylabel="Activity",
+    show=True,
+)
+
+energy_landscape_1d_animation(
+    data_sets={"u": (cann.x, us), "Iext": (cann.x, inputs)},
+    config=config,
+)
+```
+
+## Installation
+
+```bash
+# CPU-only
+pip install canns
+
+# Optional accelerators (Linux)
+pip install canns[cuda12]
+pip install canns[cuda13]
+pip install canns[tpu]
+
+# GUI (ASA Pipeline)
+pip install canns[gui]
+```
+
+Optional (uv):
+
+```bash
+uv pip install canns
+```
+
+## Docs & Examples
+
+- Documentation and tutorials: <https://routhleck.com/canns/>
+- Local scripts: `examples/`
+- Sphinx docs and notebooks: `docs/`
+- ASA GUI entry: `canns-gui`
+
+## Citation
+
+If you use CANNs in your research, please cite:
+
+```bibtex
+@software{he_2026_canns,
+  author       = {He, Sichao and
+                  Tuerhong, Aiersi and
+                  She, Shangjun and
+                  Chu, Tianhao and
+                  Wu, Yuling and
+                  Zuo, Junfeng and
+                  Wu, Si},
+  title        = {CANNs: Continuous Attractor Neural Networks Toolkit},
+  month        = feb,
+  year         = 2026,
+  publisher    = {Zenodo},
+  version      = {v1.0.0},
+  doi          = {10.5281/zenodo.18453893},
+  url          = {https://doi.org/10.5281/zenodo.18453893}
+}
+```
+
+**Plain text:**
+> He, S., Tuerhong, A., She, S., Chu, T., Wu, Y., Zuo, J., & Wu, S. (2026). CANNs: Continuous Attractor Neural Networks Toolkit (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.18453893
+
+## Contributing & License
+
+Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.
+
+Apache License 2.0. See [LICENSE](LICENSE).