Metadata-Version: 2.5
Name: qaboard
Version: 1.1.1
Summary: Visualize and compare algorithm results. Optimize parameters. Share results and track progress.
Project-URL: Homepage, https://github.com/Samsung/qaboard
Author-email: Arthur Flam <arthur.flam@samsung.com>
License: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.7
Requires-Dist: click>=7.0
Requires-Dist: importlib-metadata; python_version < '3.8'
Requires-Dist: joblib
Requires-Dist: psutil
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: rich
Requires-Dist: scikit-learn
Requires-Dist: scikit-optimize
Requires-Dist: sentry-sdk
Requires-Dist: simplejson
Provides-Extra: dask
Requires-Dist: dask-jobqueue; (python_version >= '3.9') and extra == 'dask'
Requires-Dist: distributed; (python_version >= '3.9') and extra == 'dask'
Provides-Extra: dev
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: green; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: types-pyyaml; extra == 'dev'
Requires-Dist: types-requests; extra == 'dev'
Requires-Dist: types-setuptools; extra == 'dev'
Requires-Dist: types-simplejson; extra == 'dev'
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://user-images.githubusercontent.com/2649055/86829138-bb6aef00-c09c-11ea-8b59-78b7fc44ebcf.png" alt="QA-Board logo" width="260">

  <div align="center">Experiment tracking framework with advanced viewers.</div>
  
  <div align="center">Helps algo/ml/perf engineers share results, collaborate, and build better products.</div>
</p>

<p align="center">
  <a href="https://pypi.org/project/qaboard/"><img src="https://img.shields.io/pypi/v/qaboard" alt="PyPI"/></a>
  <a href="https://samsung.github.io/qaboard"><img src="https://img.shields.io/badge/docs-master-steelblue.svg?style=flat-square" alt="Docs"/></a>
  <a href="https://github.com/samsung/qaboard/actions?query=workflow%3ACI"><img src="https://github.com/samsung/qaboard/workflows/CI/badge.svg" alt="CI"/></a>
</p>

> It's an open-source project: https://github.com/samsung/qaboard

## Features
- **Organize, View and Compare Results**, **Tuning/Optimization**
- **Web-based:** sharable URLs, no install needed.
- **Visualizations:** support for quantitative metrics, and many file formats: advanced image viewer, support for videos, plotly graphs, text, pointclouds, HTML...
- **Integrations:** direct access from Git and CI tools, easily exportable results, API, links to the code, trigger gitlabCI/jenkins/webhooks...
- **Agnostic** to your language/framework: run your existing code, write files, view them.

> For screenshots check [our website](https://samsung.github.io/qaboard).

## Benefits
QA-Board across many projects enables us to:
- **Scale R&D:** enable engineers to achieve more and be more productive.
- **Faster Time-to-Market:** collaboration across teams, workflow integration..
- **Quality:** uncover issues earlier, KPIs, tuning, reporting...

## Deployment

```bash
# Open-source, zero-downtime upgrades (see deployments/production.env)
deployments/deploy.py deployments/production.env up --build --init  # first time
deployments/deploy.py deployments/production.env up --build         # upgrades
# or plain docker compose
docker compose -f docker-compose.yml -f production.yml up -d

# With site-specific config (e.g. SIRC, DSK)
deployments/deploy.py deployments/sirc/production.env up
docker compose -f docker-compose.yml -f production.yml -f deployments/dsk/dsk.yml up -d
```

## Getting Started
[Read the docs!](https://samsung.github.io/qaboard/docs/introduction) You will learn how to:
- Start a QA-Board server
- Wrap your code with QA-Board
- View output files and KPIs
- ...and setup parameter tuning, integrations with 3rd party tools, etc.

If you want to learn about the code's organization, or how to contribute, read [CONTRIBUTING.md](CONTRIBUTING.md)


## Feedback? Questions? Need Help? Found a bug?
> Don't hesitate to get in touch! Contact arthur.flam@samsung.com, we'll be delighted to hear your insights.

If you've got questions about setup, deploying, want to develop new features, or just want to chat with the developers, please feel free to [open an issue](https://github.com/Samsung/qaboard/issues)!

Found a bug with QA-Board? Go ahead and [submit an issue](https://github.com/Samsung/qaboard/issues). And, of course, feel free to submit pull requests with bug fixes or changes to the `master` branch.

## Contributors
QA-Board was started at [Samsung SIRC](https://www.linkedin.com/company/samsung-israel-r-d-center-sirc/) by [Arthur Flam](https://shapescience.xyz).

Thanks to the following people for their contributions, testing, feedback or bug reports: Amir Fruchtman, Avi Schori, Yochay Doutsh, Itamar Persi, Amichay Amitay, Lena Grechikhin, Gal Hai, Rivka Emmanuel, Nadav Ofer. Thanks also to Sebastien Derhy, Elad Rozin, Nathan Levy, Shahaf Duenyas, Asaf Jazcilevich and Yoel Yaffe for supporting the project.

> You don't see your name? Get in touch to be added to the list!

## Credits
- The logo is a the Poodle [twemoji](https://twemoji.twitter.com/) 🐩, recolored in Samsung Blue 🔵. *Copyright 2019 Twitter, Inc and other contributors. Code licensed under the [MIT License](http://opensource.org/licenses/MIT). Graphics licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)*
